Skip to main content

API + Webhook Help

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

  • 267 Topics
  • 479 Replies
267 Topics
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.

2983
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

391
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!

1552
Y
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?

581
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!

230
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!

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

1642
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? 

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

160
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!

18812
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

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

90
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! 

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

1113
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?

753
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 🙏🙏🙏

732
K
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

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

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

250
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 

310
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 

760
W
S
Sai30517Community Member
asked in API + Webhook Help
Refresh token api calls failure

Hi community,when i refresh the oauth token using the calendly apiurl: `https://auth.calendly.com/oauth/token`method: POSTdata: 'grant_type=refresh_token&refresh_token=<refresh_token>' it throws bad request errorcode: 'ERR_BAD_REQUEST',response:     data: {      error: 'invalid_grant',      error_description: 'The provided authorization grant is invalid, expired, revoked, does not match the redirection URI used in the authorization request, or was issued to another client.'    }please help or suggest what could be the issue, we are following the api reference correctly,this happens when token gets expired multiple times and after multiple times of refresh it throws the above error or let’s say the oauth token expired and later after when refreshing the token throws the above error 

1141
M
Employee
Y
yogeshCommunity Member
asked in API + Webhook Help
Refresh token using oauth with calendly api encounters failure

Hi community,when i refresh the oauth token using the calendly apiurl: `https://auth.calendly.com/oauth/token`method: POSTdata: 'grant_type=refresh_token&refresh_token=<refresh_token>' it throws bad request errorcode: 'ERR_BAD_REQUEST',response:     data: {      error: 'invalid_grant',      error_description: 'The provided authorization grant is invalid, expired, revoked, does not match the redirection URI used in the authorization request, or was issued to another client.'    }please help or suggest what could be the issue, we are following the api reference correctly,this happens when token gets expired multiple times and after multiple times of refresh it throws the above error or let’s say the oauth token expired and later after when refreshing the token throws the above error

2703
S
M
Moreno56785Community Member
asked in API + Webhook Help
Message events not working

I can’t get the message events to trigger on plain js embed. Here is the code: function init() { const link = document.createElement('link'); link.rel = 'stylesheet'; link.type = 'text/css'; link.href = `https://seaspaceai.b-cdn.net/global/calendly-pop-up-styles.css`; document.head.appendChild(link); // Define the function for adding a button window.addCalendlyButton = function(newOutputDiv) { const calendlyContainer = document.createElement('div'); calendlyContainer.className = 'button-container'; newOutputDiv.appendChild(calendlyContainer); const calendlyButton = document.createElement('button'); calendlyButton.className = 'calendly-button'; calendlyButton.id = 'calendly-button'; calendlyButton.addEventListener('click', function() { if (window.Calendly) { Calendly.initPopupWidget({ "url": 'https://calendly.com/link', "prefill": {}, "parentElement": document.getElementById('calendly-button'), "utm": { "

860
M
W
WEBSUDIOCommunity Member
asked in API + Webhook Help
Comment trouver son API sur son compte ?

Je cherche à trouver ma clé API sur mon compte Calendy pour l’intégrer à mon MAKE.Où puis-je trouver ces informations ?

1061
David
Community Manager
Terms & ConditionsCookie Settings