Skip to main content

API + Webhook Help

Got questions on API, webhooks, code, and more? Developer Community has answers.

  • 225 Topics
  • 434 Replies
225 Topics
J
Josh00456Community Member
posted in API + Webhook Help
Request: API Endpoint to Schedule Events Directly

I’m reaching out to request a critical feature for Calendly’s API: an endpoint to schedule events programmatically without requiring invitees to select a time slot via a scheduling link. This capability is essential for my business, and I believe it would benefit many other developers in the community as well. The ProblemMy team is building AI solutions in a highly competitive industry where scheduling needs to be seamless and immediate—often over the phone or through automated workflows. Currently, Calendly’s API (as of March 2025) allows us to fetch availability and event details, but there’s no way to directly schedule an event. Instead, we’re forced to send a scheduling link or direct clients to a website to book, which isn’t feasible for our use case. This limitation creates friction:Clients expect instant scheduling during live interactions (e.g., phone calls to our Voice AI agent or via SMS chat with our AI agent). Sending a link or requiring a website visit adds unnecessary ste

161
A
Employee
H
hehub000Community Member
asked in API + Webhook Help
How can I get start and end time info from an embedded booking page to my parent website?

I use Calendly to manage availability and event booking for my website, and users provide their Calendly embedded booking page URL when they sign up so other users can directly schedule meetings with them. However, my website has it’s own calendar that I want to sync with each user’s Calendly calendar. In order to do this, I just need the start and end times of events that users schedule with each other using Calendly.I need some way to get the start and end time of events when they are booked from the embedded page to my parent website. Embedded pages send a notification to the parent window when an event is scheduled, but the payload only contains the event URI and not the fields I need.I also tried making a GET request to the Calendly API every time an event is scheduled based on the event URI, but the GET Event request only gives permission when the caller is the event owner, not an invitee.Has anyone found a way to do what I’ve described? I would appreciate any help. Thanks.

141
A
Employee
K
Kevin26381Community Member
posted in API + Webhook Help
Expose more fields than just `uri` for `calendly.event_scheduled`

Feature RequestThe https://developer.calendly.com/api-docs/2d6c9df9b89de-notifying-the-parent-window, and personal testing confirms that the only data available to the parent window when an event is scheduled  (calendly.event_scheduled) is the uri of the event and invitee. However, I see in the network tab that many fields are returned. Can you expose all, or some of these other fields? At least start_time, end_time, and uuid My Use CaseI would like to create my own “you are scheduled” page, because calendly is just one of the steps in my flow. I would like to show my users this ‘scheduled’ information alongside a few more “what’s next/what to expect”, my own styling for FAQ link, etc.

2613
H
L
Lior34306Community Member
asked in API + Webhook Help
Zoho Calendar Integration

Hello, Zoho is a 100 million users platform and there is no integration between Zoho Calendar and Calendly. Its a big calendar that suppose to have a representation in Calendly. I already talked to Zoho and if you are interested they will put the resources to assist with the integration.  Let me know,Lior

131
David
Community Manager
Y
Yeabsera27512Community Member
asked in API + Webhook Help
500 Internal Server Error – Create One-Off Event Type API

I am encountering a 500 Internal Server Error when attempting to create a one-off event type using the Calendly API. The response I receive is:{ "title": "Internal Server Error", "message": "The server encountered an unexpected condition that prevented it from fulfilling the request."}Here is the request payload and configuration I am using:const data = { name: "My Meeting", host: uri, co_hosts: [], duration: 30, date_setting: { type: "date_range", start_date: "2025-2-6", end_date: "2025-3-6", }, location: { kind: "physical", location: "Main Office", additional_info: "string", },};const options = { method: "POST", url: "https://api.calendly.com/one_off_event_types", headers: { "Content-Type": "application/json", Authorization: `Bearer ${accessToken}`, }, data,};Any guidance or clarification would be greatly appreciated. Thank you!

1312
Y
Y
Yeabsera27512Community Member
asked in API + Webhook Help
Getting "Invalid Argument" Error When Using List User Availability Schedules API

Hello,I'm currently working on integrating Calendly into my application, and I'm encountering an issue when trying to fetch availability schedules using the "List User Availability Schedules" API. Whenever I make the request, I get the following error message:{ "title": "Invalid Argument", "message": "The supplied parameters are invalid.", "details": [ { "parameter": "string", "message": "string", "code": "string" } ]}Thank you in advance for your help!

867
C
Employee
L
LudwiggCommunity Member
asked in API + Webhook Help
Is it possible to use this API (https://calendly.com/api/users/{user_id}/event_types) to create an event without needing to access Calendly?

So I realized that I can't create an event using the official Calendly API. But when I create an event on my user page I noticed that it calls another endpoint to create them. So, is it possible? How can I do this?

251
C
Employee
W
WeCraftly53034Community Member
posted in API + Webhook Help
API Feature Request: Time Range Availability Check & Appointment Creation

Wouldn’t it be great if the Calendly API allowed you to send a time range (a start time and an end time) and then receive a response indicating whether that time slot is available? I envision an API endpoint where you send a new appointment request with a specified start and end time, and Calendly returns:• Whether that time slot is available for scheduling, and• If available, the option to create a new meeting/appointment directly via the API. This feature would make it much easier to integrate Calendly into automated workflows and scheduling systems by allowing us to quickly check availability and then book appointments if the slot is free. Looking forward to feedback and discussions on this idea!

100
W
P
Paulus74625Community Member
asked in API + Webhook Help
event_type_available_times fails if start_time is in the past

The event_type_available_times endpoint fails if start_time is in the past. In fact if fails with an opaque 400 error:`The supplied parameters are invalid`It took me an hour to debug this non-obvious behavior.Can you please document this behavior in the api docs, return a meaningful error message in the api response, or preferably both?Thanks!

341
C
Employee
K
Kevin26381Community Member
asked in API + Webhook Help
Invalid Argument for "event_type_available_times" endpoint

curl --request GET \ --url 'https://api.calendly.com/event_type_available_times?event_type=https%3A%2F%2Fapi.calendly.com%2Fevent_types%2Fd9ceda1a-7a6e-4fa1-b0af-59c2df7c2387&start_time=2020-01-02T20%3A00%3A00.000000Z&end_time=2020-01-07T24%3A00%3A00.000000Z' \ --header "Authorization: Bearer $BEARER_TOKEN" \ --header 'Content-Type: application/json'What’s wrong with my request? I tried using the request-creator tool in the docs: https://developer.calendly.com/api-docs/6a1be82aef359-list-event-type-available-times, but in that UI or in curl, i get the same error: {"title":"Invalid Argument","message":"The supplied parameters are invalid."}For reference, I got this event_type uuid from a successful call to the  https://api.calendly.com/event_types endpoint.

912
C
Employee
M
monikalyzwaCommunity Member
asked in API + Webhook Help
First available slot - how to fetch via API?

Hello!For number of days we are trying to fetch information about the first available slot for an event (API) to present on our website. Unfortunately, we are doing something wrong. Here’s a message from my developer: We have fetched all event_types from the user. We are trying to retrieve the schedule for a specific event.URI: https://api.calendly.com/event_types/1fd06bb2-983f-4847-9751-ebd631d21f7a | UID: 1fd06bb2-983f-4847-9751-ebd631d21f7aWe are attempting to do this using the following endpoint: https://developer.calendly.com/api-docs/6a1be82aef359-list-event-type-available-times Unfortunately, it doesn’t work, neither in the code nor via the link above.We are passing the following parameters: • end_time: 2025-02-13T01:00:00.000000Z • event_type: https://api.calendly.com/event_types/1fd06bb2-983f-4847-9751-ebd631d21f7a • start_time: 2025-02-20T01:00:00.000000ZWhat are we doing wrong? 

512
C
Employee
M
Minha23032Community Member
posted in API + Webhook Help
The specific issue (cookie settings panel in an embed)

I've disabled the cookie notification pop-up within the embedded content, but the cookie preferences section still appears to be visible. This is creating layout issues with the margins when the page responds to different screen sizes.Would it be possible to completely remove this cookie-related element from the embed? This would give us better control over the spacing and dimensions surrounding the embedded content.

80
M
JonT
JonTCommunity Member
asked in API + Webhook Help
Dark mode support for the embedded booking widget

We are trying to use the embedded booking widget on our website and it works well except when our site is in dark mode. I provide custom colours using the ?background_color=xxx&text_color=xxx&primary_color=xxx options. It works well but the generated iframe has a white background instead of being transparent. The generated Calendly iframe does support a transparent background colour but the generated iframe needs to have this added into the head section:<meta name="color-scheme" content="light dark">I found the fix here: https://stackoverflow.com/a/77604431/343If I manually add this tag using the browser inspector it works fine and the iframe has a transparent background again. Is it possible to have this tag added to the generated iframe so that we can have full dark mode support? Thanks!

16492
Thobani13115
R
Rachel55626Community Member
asked in API + Webhook Help
Marking Rescheduled Meetings as Rescheduled

​@Austin I’m finally working on implementing the process you outlined in this post:  But I’m running into one problem. My CancelEventTemplate that I copied from the installed package has this in the Subject line: {!$Record.Calendly__EventSubject__c} - Calendly - {!$Record.Calendly__InviteeUuid__c} There is no “Canceled” verbiage to update to “Rescheduled”. However, even though this flow is active without “Canceled” in the subject, my events in Salesforce are changing to Canceled. So I’m wondering if there is something else inside of Calendly that is putting “Canceled” in the subject line and passing it over?  I did try adding “Rescheduled” to my flow to see what would happen. I tested it out, and the rescheduled meeting in Salesforce ended up with the subject “Rescheduled: Canceled: Subject - Calendly - ID”. So I’m thinking there has to be something outside of the Flow that is setting the title to “Canceled”.  If I need to put in a ticket, I will, but I thought I’d start with you to se

412
R
S
Sarmad27642Community Member
asked in API + Webhook Help
Sarmad

I have used embedded code option to embed calendly  to my website and i am using the following developer code<div class="calendly-inline-widget" data-url="https://calendly.com/YOUR_EVENT?hide_gdpr_banner=1" style="min-width:320px;height:630px;"></div><script type="text/javascript" src="https://assets.calendly.com/assets/external/widget.js"></script>Even with the added code hide_gdpr_banner=1 in the URL link, it is still showing banner on the mobile while on the computer site, its working fine.Let me know what i can do to eliminate that.

60
S
M
Moustafa08806Community Member
asked in API + Webhook Help
Multiple languages or english Calendly on a German Website

Hi Calendly,we have a German website with two languages, German and English. The website should be for people in Germany that couldn't speak the german language. It would be perfect if we could present Calendly in both languages in the right language. But if not, it would be more important if we could get Calendly in english. We setted up the form on english, but on the website we got it on german. I tried different things. I tried to set up the Calendly-URL like this "?locale=en", I tried to use for implementation Javascript and an Iframe. I chanaged system and browser language and nothing helps. Is it an IP-Localisation Script and is there no other options for the languages?Thank you for your help! 

1277
W
I
Interviews71310Community Member
asked in API + Webhook Help
webhook

I’ve successfully created a webhook. However, it only triggers when an event is created or cancelled if I am simultaneously logged on to the Calendly web page. I understood it would run on every event called by the trigger.  I am trying to work out if this is by design (and I’m misunderstanding how they work) or the result of a misconfiguration.  NB I’ve created the webhook using the API Key and an oath token with the same result. What I’m trying to achieve is:Create a single use link using the API have a user book an event have that event trigger a webhook (calling an http trigger in PowerAutomate)I hope some can help. 

903
A
Employee
F
fastisfCommunity Member
asked in API + Webhook Help
Unable to view the iframe and calendar

Hello,I have spent a whole day trying to integrate calendly on my landing page but still unsuccessful. I have tried all options - inline, popup and all react integrations like react-calendly but all of them give the same issue - I see the spinner but never the calendar in the iframe.I have also tried z-index manipulation of calendly-popup element.What I have observed is - I get a “scribe-shadow” HTML element which has the max z-index value, so I dynamically try to bring its z-index down and our calendly-popup z-index up so that I can view the iframe content - no effect.I am using React 17 and using dynamic js and css calendly scripts to my page.Has anyone dealt with this problem?

553
F
K
Kier02858Community Member
asked in API + Webhook Help
Calendly page is not showing properly on mobile

Hi there. Just encountered issue with my Calendly on my Wordpress site. The calendar doesnt show up on mobile view. Can you please help me how to fix this one? The website page is https://adastraawakening.com/book-a-call/ Hope you can help me 🙏🙏🙏

402
K
H
hectormxnCommunity Member
posted in API + Webhook Help
scheduled events from API

We are trying to create an event (a meeting) through the API but when doing it as in its documentation it sends me a 404 errorhttps://api.calendly.com/scheduled_events/ Does anyone know how to achieve this?

3006
S
J
jbrownInstrumentlCommunity Member
asked in API + Webhook Help
How to find "Shared Events" through the API?

I’m attempting to find all of the “Shared Event Types” in my organization (the ones whose edit URLs look like https://calendly.com/organization_event_types/<id>/edit ); it appears that none of them are returned through the list user's event types endpoint when invoked with an organization ID. If I invoke the list endpoint with an individual user ID instead of the organization ID, I can find them, but it’s not particularly efficient to iterate through all of my users and separately enumerate their event types. Is there some extra undocumented flag I can pass to the API to find these events? Here’s an example of the JSON bodies of one of these events:{ "active": true, "admin_managed": false, "booking_method": "instant", "color": "#8247f5", "created_at": "2021-10-12T17:46:08.811213Z", "custom_questions": [ { "answer_choices": [], "enabled": true, "include_other": false, "name": "US Phone Number", "position": 0, "required": true, "type": "s

740
J
S
Samen28616Community Member
asked in API + Webhook Help
calendly widget not showing

My Calendy agenda is working great as an inline om my website bookingspage (I did that via custom html).Now I wanted to create a pop up widget for all other pages so I followed the steps given here: https://help.calendly.com/hc/en-us/articles/223195568-How-to-add-Calendly-to-a-WordPress-site#h_01J7H1YC4JAR18PGZ4MTQAB0RXI did add (like option 2 suggested) the code to the footer.php but the widget is not showing on any page. Except on one page, my bookingpage on which I also had the inline via custom html. So only on that page there is now a calendar + a widget.How to get a widget on all pages (except on the calender/booking page)?Many thanks for your feedback. 

492
S
A
Ahmed35856Community Member
asked in API + Webhook Help
Can't fetch scheduled events through api for organization with multiple users

I am using calendly trial version. As I have multiple user in my organization account I cant fetch scheduled events through API. I am using personal token.

240
A
W
W74417Community Member
asked in API + Webhook Help
API details for creating an appointment in Calendly

Kindly someone provide me with the API details for creating an appointment in Calendly as the below does not seem to work.https://api.calendly.com/scheduled_events/<eventid>/invitees 

220
W
W
wan222Community Member
asked in API + Webhook Help
Pass-through UID data from embeded site

Hi,Im building a website with Firebase that is user-based.I have embedded a Calendly calendar in my website.Id like to be able to pass through the Firebase UID of the user that is booking through the Calendly….Is it possible to have the users Firebase UID attached to the booking when its made and passed through the booking process. Then once the booking is complete that UID is passed through with the rest of the booking data through the webhook payload….. So that I can identify who has made the booking and perform user-depentant functions on my Firebase backend?Thanks 

600
W
Terms & ConditionsCookie Settings