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.
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.
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.
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.
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.
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