Release Notes

See what’s new with Calendly’s API

October 2021 Updates

UUID format is now updated

We've updated the length and formatting of UUID to 255 characters and ASCII for newly created Users and Organizations. This change will not affect existing UUIDs. As mentioned in our API Conventions, we recommend using URI to identify the resources instead of an ID to avoid any disruption to your integrations.

April 2021 Updates

Access tokens now contain more characters

We’ve updated the formatting of our access tokens. You can still make requests to our API the same way, but now the character length of access tokens is around 370 characters instead of 43 characters. We recommend storing access tokens (along with webhook signing keys) within a database column without length restrictions or with a very high character limit.

March 2021 Updates

Personal access tokens are available for authenticating to API

The v2 API now supports personal access tokens as a second method of authentication. An individual Calendly user or organization can use a personal access token to connect to internal automations. Any automations or integrations that allow multiple Calendly users to connect should use OAuth. See more here. 

Webhook signing keys supported for webhook subscriptions created with personal access tokens

When creating a webhook subscription using personal access tokens, developers can optionally set a webhook signing key. This lets developers verify expected signatures using the signing key. Developers working with OAuth should already have a signing key associated with their OAuth app. See more here.

February 2021 Updates

Event type endpoint includes organization parameter

Authenticated Calendly owners and admins can make a call to this endpoint using the optional organization parameter to return event types across all users in the Calendly organization. To get the organization parameter related to the authenticated owner or admin, they can make a call to this organization endpoint using the user parameter.

Invitee model includes payment amount

When a Calendly user connects a payment integration to collect payment at the time an event is scheduled, the amount the invitee paid will be included in the invitee model.

January 2021 Updates

Programmatically create single-use links

Use the scheduling links endpoint to create links that will expire once one event has been booked with them.

Event Resource includes additional guests

The event resource will now include the email addresses of any additional guests the invitee adds while booking the event. The event resource is included in the response from the scheduled event endpoint.

Invitee model includes cancellation event

When an invitee is canceled, the person who canceled the invitee and any reason provided is included in the invitee model.

December 2020 Updates

Scheduled events endpoint includes organization parameter

Authenticated Calendly owners and admins can make a call to this endpoint using the optional organization parameter to return events across all users in the Calendly organization. To get the organization parameter related to the authenticated owner or admin, they can make a call to this organization endpoint using the user parameter.

Cancel and reschedule links are included in the invitee resource

The invitee resource is included in the webhook payload and the response to the invitee endpoint.