v12

latestOpenAPI 3.0.0raw.githubusercontent.com2025-11-282935165.9 KB
Oauth

Refresh OAuth token

Refresh an OAuth access token using the refresh token

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

Path parameters

integration_idstring required

Integration identifier

connection_idstring required

Connection identifier

Query parameters

refresh_tokenstring required

Refresh token

Response

Token refreshed successfully

access_tokenstring

OAuth access token

token_typestring

Token type (usually Bearer)

refresh_tokenstring

OAuth refresh token

expirystring date-time

Token expiration time

expires_ininteger

Token expires in seconds

sequenceinteger

Message sequence number

subjectstring

Message subject

modifiedinteger

Last modified timestamp

Example response

{
  "access_token": "eyJhbGciOiJSUzI1Ni...",
  "expires_in": 1800,
  "expiry": "2025-05-29T17:09:39.816102+01:00",
  "modified": 1748533179,
  "refresh_token": "ulpL_...",
  "sequence": 85,
  "subject": "ms.integration.oauth.AC75JGNMJHTRQNXCBDMIAJCJ57HAEWP2RGWXJCIFFGW2K64OKG267A2D.xero.demo",
  "token_type": "Bearer"
}