POST /oauth/token

After the customer has confirmed the app installation, you will need to exchange the authorization_code to a pair of access and refresh tokens. Using an access token, you can access the user's data through the API.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

Authorization String Yes

Base 64 encoded string containing the client_id and client_secret values. The header value should be Basic <base64(client_id:client_secret)>.

Request body fields

Name Type Required Description
grant_type String No

Since you are trying to exchange an authorization code for a pair of tokens, you must use the value "authorization_code"

Possible values:

  • "refresh_token"
  • "authorization_code"

Default value: "authorization_code"

code String No

The authorization code that you received after the user confirmed app installation

redirect_uri String No

The callback URL you provided when you registered your app

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.