Refresh OAuth token

Refresh an OAuth access token using the refresh token

GET /hub/integrations/{integration_id}/oauth-refresh-token/{connection_id}

Refresh OAuth token

cURL

curl --request GET \
  --url https://api.quiva.ai/hub/integrations/{integration_id}/oauth-refresh-token/{connection_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "access_token": "eyJhbGciOiJSUzI1Ni...",
  "token_type": "Bearer",
  "refresh_token": "bmV3UmVmcmVzaFRva2VuVmFsdWU...",
  "expiry": "2025-05-30T18:00:00.000000+01:00",
  "expires_in": 1800,
  "sequence": 87,
  "subject": "ms.integration.oauth.AC75JGNMJHTRQNXCBDMIAJCJ57HAEWP2RGWXJCIFFGW2K64OKG267A2D.xero.maria",
  "modified": 1748622000
}

Authorizations

bearerAuthapiKeyAuth

Authorization · string · header · required

JWT Authorization header using the Bearer scheme

Path Parameters

integration_id · string · required

Integration identifier

connection_id · string · required

Connection identifier

Query Parameters

refresh_token · string · required

Refresh token

Response

200

application/json

Token refreshed successfully

access_token · string

OAuth access token

Example:

"eyJhbGciOiJSUzI1Ni..."

token_type · string

Token type (usually Bearer)

Example:

"Bearer"

refresh_token · string

OAuth refresh token

Example:

"ulpL_..."

expiry · string<date-time>

Token expiration time

Example:

"2025-05-29T17:09:39.816102+01:00"

expires_in · integer

Token expires in seconds

Example:

1800

sequence · integer

Message sequence number

Example:

85

subject · string

Message subject

Example:

"ms.integration.oauth.AC75JGNMJHTRQNXCBDMIAJCJ57HAEWP2RGWXJCIFFGW2K64OKG267A2D.xero.demo"

modified · integer

Last modified timestamp

Example:

1748533179