Exchange public token

This endpoint will change the temporary publicToken that you receive from the Link flow for a valid connectionToken that is permanent and can be used to retrieve connection information. A connection is not considered "active" until its publicToken is exchanged.

Exchange public token for connection token

post

Exchanges public token for connection token from an app

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

publicTokenstring · uuidRequired

Public token pending to convert

Responses

200

Successfully exchanged public token for connection token

application/json

401

Invalid credentials

application/json

404

Connection not found with the given public token for the current app

application/json

500

Internal server error

application/json

post

/api/v1/commands/connections/exchange/{publicToken}

HTTPcURLJavaScriptPython

POST /api/v1/commands/connections/exchange/{publicToken} HTTP/1.1
Host: api.finlink.vumi.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "connectionToken": "AAAAA11111"
}