Issues a new Access token (optionally identity_token & refresh_token) in exchange of Oauth grant

POST /v1/token
application/x-www-form-urlencoded

Body Required

  • grant_type string Required

    Grant type is a credential representing resource owner's authorization which can be used by client to obtain access token.

  • client_id string Required

    A 34 character string that uniquely identifies this OAuth App.

  • client_secret string

    The credential for confidential OAuth App.

  • code string

    JWT token related to the authorization code grant type.

  • redirect_uri string

    The redirect uri

  • audience string

    The targeted audience uri

  • refresh_token string

    JWT token related to refresh access token.

  • scope string

    The scope of token

Responses

  • 201 application/json

    Created

    Hide response attributes Show response attributes object
    • access_token string | null

      Token which carries the necessary information to access a Twilio resource directly.

    • refresh_token string | null

      Token which carries the information necessary to get a new access token.

    • id_token string | null

      Token which carries the information necessary of user profile.

    • token_type string | null

      Token type

    • expires_in integer(int64) | null
POST /v1/token 
curl \
 --request POST 'https://preview-iam.twilio.com/v1/token' \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'code=&scope=scope&audience=&client_id=OQ7cda1a615f05a95634e643aaaf7081d7&grant_type=client_credentials&redirect_uri=&client_secret=sUWblrQ4wx_aYkdAWjHXNvHinynkYOgBoiRyEQUeEntpgDEG47qnBFD98yoEzsTh&refresh_token=refresh_token'
Request example 
{"code"=>"", "scope"=>"scope", "audience"=>"", "client_id"=>"OQ7cda1a615f05a95634e643aaaf7081d7", "grant_type"=>"client_credentials", "redirect_uri"=>"", "client_secret"=>"sUWblrQ4wx_aYkdAWjHXNvHinynkYOgBoiRyEQUeEntpgDEG47qnBFD98yoEzsTh", "refresh_token"=>"refresh_token"}
Response examples (201) 
{
  "id_token": "eyJhbdGciOiIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
  "expires_in": 1438315200000,
  "token_type": "bearer",
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
  "refresh_token": "ghjbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}