bookings

Cal.com Token Refresh & Integration

View as Markdown

Refreshes Cal.com access token for the authenticated user. For first-time users, this endpoint will also handle the initial Cal.com integration implicitly, including user creation and token setup.

Request

This endpoint expects an object.
force_refreshbooleanOptionalDefaults to false
Force refresh even if token is still valid
cal_emailstringOptionalformat: "email"

Email for Cal.com integration (optional, defaults to user’s email)

timezonestringOptionalDefaults to UTC

Timezone for Cal.com integration (optional, defaults to UTC)

Response

Token refreshed successfully or integration completed
access_tokenstring
New Cal.com access token
refreshedboolean
Whether the token was refreshed or was still valid
integration_statusstring

Integration status: ‘created’ for new users, ‘existing’ for returning users

cal_client_idstring
Cal.com OAuth client ID for frontend API integrations
expires_ininteger
Token expiry time in seconds
token_typestringDefaults to Bearer
Token type

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error