When you create a webhook subscription, payloads will be sent in real time to your server endpoint when events are scheduled or canceled by either the host or the invitee. When you create a webhook subscription, you can subscribe to either or both:
invitee.created for only data about scheduled events by invitees
invitee.canceled for only data about canceled events by invitees
routing_form_submission.created for only data about routing form submissions
Subscribing to both
invitee.canceled events will return all scheduled and canceled events across all team members in your organization with a single subscription giving you full transparency into the success of meetings.
Subscribing to the
routing_form_submission.created event will fire anytime someone submits a routing form, whether they book or not. NOTE: The only allowed subscription scope for Routing form submissions is
If you’re an owner or admin, the personal access token you generate will authenticate the POST request with:
user scope if you want to return a response payload for data about all scheduled events for yourself
organization scope if you want to return a response payload for data about all scheduled events for your organization
If you’re a team member and not an owner of admin of a Calendly organization, the personal access token you generate will only authenticate the POST request with the
user scope to return a response payload for data about your own scheduled events.
Before you create a webhook subscription, ensure that you have the
organization or the
user URI (see how to find the organization or user uri) depending on which events you want to scope for.
Make a POST request to the
Add your personal access token to authenticate the request.
Set your server endpoint in the
routing_form_submission.created (or all 3) for the
organization value to isolate scheduled events to yourself or the organization.
curl --request POST --url https://api.calendly.com/webhook_subscriptions
--header 'Content-Type: application/json'
--header 'authorization: Bearer <your personal access token>'
(Optional) To get data about an invitee such as name, email, and their answers to custom questions on an event booking page, use the URI property in the webhook payload to make a GET request to the
When an invitee cancels an event, you can match them to an existing invitee in your system by comparing the URI. This will allow you to exclude the invitee or event from your data, or specifically track canceled or rescheduled events.