oAuth

Get Access Token

Use Access Tokens to access Calendly resources on behalf of an authenticated user.

The Basic HTTP Authentication security scheme is for web clients only.

To make a call to this endpoint:

  • Web clients: pass client_id and client_secret via Basic HTTP Authorization header

  • Native clients: include client_id as a body param within the API call

Note:

  • Access Tokens expire after 2 hours.

  • Refresh Tokens don't expire until they are used.

  • Only 8 oauth tokens per user can be requested within a span of 1 minute

post/oauth/token

Request

  • Base URL: https://auth.calendly.com
  • URL: https://auth.calendly.com/oauth/token
  • Auth: HTTP basic

Request body

OR
OR
OR

Response

OK

token_type'Bearer' required

The token type (currently this is always "Bearer")

access_tokenstring required

The access token provided in the response

refresh_tokenstring required

The refresh token provided in the response

scopestring

The scope of the access request

created_atnumber double required

The UNIX timestamp in seconds when the event was created

expires_innumber double required

The number of seconds until the access token expires

ownerstring uri required

A link to the resource that owns the token (currently, this is always a user)

organizationstring uri required

A link to the owner's current organization

Changes

No recorded changes to this operation across all 1 revision of this API.