Get a platform user's connection to a 3rd Party Application
This endpoint can be used by your server to retrieve an access token for a user's connection to a 3rd party application. It will automatically refresh expired access tokens if the corresponding service supports it.
If the user has not been provisioned, the endpoint will return a 404
status code.
If the user has not yet enabled the connection, the enabled
parameter of the connection
will be false
.
If the user has enabled the connection, but no access token is available, the access_token
parameter of the authorization
will be empty, and the status
parameter will be something other than active
(most commonly error
).
If the user has multiple connection to a given service, the endpoint will return the "healthiest" connection (i.e. prefer connections that are enabled
and active
). If you're working with multiple connections, you should instead use Get Connection by ID.
See the Retrieving Access Tokens Guide for examples of how to use this endpoint.