Get access token

Exchanges an authorization code for an access token, or refreshes an existing access token.

POST /oauth/token

Get access token

cURL

curl --request POST \
  --url https://auth.calendly.com/oauth/token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data grant_type=authorization_code \
  --data 'client_id=<string>' \
  --data 'code=<string>' \
  --data 'code_verifier=<string>' \
  --data 'redirect_uri=<string>' \
  --data 'client_secret=<string>'

200

{
  "access_token": "<string>",
  "refresh_token": "<string>",
  "token_type": "Bearer",
  "scope": "<string>",
  "expires_in": 123,
  "created_at": 123,
  "owner": "<string>",
  "organization": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/x-www-form-urlencoded

Option 1

Option 2

grant_type · enum<string> · required

Available options: authorization_code

client_id · string · required

code · string · required

code_verifier · string · required

redirect_uri · string<uri> · required

client_secret · string

Response

200 - application/json

OK

access_token · string

refresh_token · string

token_type · enum<string>

Available options: Bearer

scope · string

expires_in · integer

created_at · integer

owner · string<uri>

organization · string<uri>