Skip to main content

API + Webhook Help

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

  • 298 Topics
  • 568 Replies
298 Topics
J
Jitjatjo47143Community Member
asked in API + Webhook Help
UTM params are removed with redirect

I have  https://www.calendly.com/jjj-testing/?utm_medium=social&utm_source=facebook&utm_campaign=summer%20promotion&salesforce_uuid=ffeddb07-041a-4df0-9f22-999c6c7a0740&name=Fredy%20Haag&email=fredyU.haag%40autotest.com when I visit this link utm_* is removed but salesforce_uuid stays in place. In the result I receive only salesforce_uuid in webhook. Why this happens and how to prevent removing of UTM? 

371
Austin
Community Manager
L
Liandroid1111Community Member
asked in API + Webhook Help
The embed code gives an error in wordpress

I have tried some of the recommendations in the help articles but I still can get the embed code to book an event show up correctly on my website. I added the embed code as custom html. the preview looks great but on the site the calendar does not appear but the link https://assets.calendly.com/assets/external/widget.js Could anyone help me troubleshoot to help visitors to my website see the embedded calendar. Thanks.

261
Austin
Community Manager
T
tannerCommunity Member
asked in API + Webhook Help
Pending Scheduled Events and Creating Meeting Polls via API

Hello,I'm currently working on integrating Calendly more deeply into our scheduling workflow and have several questions regarding the API's capabilities, specifically around scheduled events and meeting polls. Querying Pending Events: Is there a way to specifically query for scheduled events that are in a 'pending' state, such as meeting polls? This functionality would be incredibly useful for managing large numbers of appointment requests. Creating Meeting Polls via API: While the API documentation provides details on creating One-Off Event Types, I am curious if there is a similar capability for creating meeting polls. I noticed that the event type class includes a pooling_type attribute. Could this be utilized to create meeting polls, and if so, could you provide some guidance or point me to the relevant documentation? I appreciate any help or direction you can provide. Thank you for supporting the community with your insights!

4876
B
W
WaggingLabsCommunity Member
asked in API + Webhook Help
Embed form color variables differ from what was selected

I created an inline embed widget and set the text color to white #fff. However, the color that renders based on the colorTextStandard variable is #dedede.  Below is the script I’m using. You can find the widget at the bottom of wagginglabs.com<!-- Calendly inline widget begin --><div class="calendly-inline-widget" data-url="https://calendly.com/wagginglabs/chat?hide_event_type_details=1&hide_gdpr_banner=1&background_color=162035&text_color=ffffff&primary_color=99eff1" style="min-width:320px;height:700px;"></div><script type="text/javascript" src="https://assets.calendly.com/assets/external/widget.js" async></script><!-- Calendly inline widget end --> 

1412
W
J
jimmy07044Community Member
asked in API + Webhook Help
Cookie banner re-appears after first meeting booked despite disabling it

I have used the following code to ensure the cookie banner doesn’t appear:hide_gdpr_banner=1On initial load of the calendar page the banner doesn’t appearBut after someone has booked their first meeting and the calendar allows you to book a second meeting the cookie banner re-appears.How can I stop this from happening?I’m using Divi builder on Wordpress  

403
C
G
grandcircusCommunity Member
asked in API + Webhook Help
Calendly Embed Error: Inline embed visually showing twice but only embedded once

Hi everyone,I’m having the issue where all of a sudden starting yesterday our embedded calendly inline widgets started appearing visually twice on the website. It looks super unprofessional and annoying and we’ve never had this issue before. All of the embed have existed prior to yesterday and have worked great for months, nothing’s changed. It’s happening on our wordpress site AND our hubspot landing pages. I’ve tried everything debugging wise on wordpress etc and I can’t find any reason for this to happen out of the blue. I’ve hidden the doubles under a white backround from the section beneath right now, but the site is grandcircus.co if anyone wants to look at the code.Please help! Oliver  

3974
A
D
Doe06475Community Member
asked in API + Webhook Help
Enhancing Calendly Widget: Styling, Responsive Design, and Event Management

Hey Calendly Community,I'm working on adding Calendly to our custom web app, and I could use some help with a few things.Here’s what I’m facing:Styling Customization: I want to change how the Calendly widget looks to match our app's design. I've tried using CSS, but it seems like Calendly’s default styles are overriding mine. How can I make my custom styles work?Responsive Design: Our app is designed to work well on all screen sizes, but the Calendly widget doesn’t resize properly on smaller screens. It looks off and affects the user experience. How can I make the widget more responsive?Event Handling: I need to know when certain events happen in the Calendly widget, like when someone schedules or cancels an appointment. I want to run some custom code when these events occur. How can I capture and handle these events in my app?If you have any advice, code examples, or tips on these issues, please share. Your help would be greatly appreciated!Thanks!

22065
K
T
Tems.hkCommunity Member
asked in API + Webhook Help
Token of API V1 does not work with API V2

Hi,I’m using Flutterflow and tested on postman. Here is the API call which does work wellhttps://api.calendly.com/users/c87babc0-4bb4-4659-9ed5-f4ac3f6c6202/ And here is the API V2 call which does not workhttps://api.calendly.com/scheduled_events?count=5&page_token=MY_TOKEN&user=https://api.calendly.com/users/c87babc0-4bb4-4659-9ed5-f4ac3f6c6202 I made the test with Postman and Reqbin, still the same result{  "title": "Unauthenticated",  "message": "The access token is invalid"}Maybe, I missed something or I misunderstanding but I’m looking for why I get this error message. Thank you  for your helpPS : I’m under 14days trial before starting the paid version. WOuld it be a limitation for the free version ?

591
T
K
K78647Community Member
asked in API + Webhook Help
Calendly event not added to GCal

I updated to Chrome browser v135.0.7049.42 today and a Calendly event came through before I had restarted Chrome. Calendly says my Google calendar is still connected, the event shows up in my Calendly meetings list, and I got the notification email but it does not appear on my calendar. There does not seem to be a way to re-send a calendar invite from the Calendly dash, or download an ics file so I guess I just have to manually create the event and it won’t be synced to Calendly? I am concerned this will be an ongoing issue in the latest Chrome update.

431
David
Community Manager
T
trunkey2003Community Member
asked in API + Webhook Help
Calendly Embedding: Delayed Load

The embedded Calendly didn’t load until I scrolled it into view, which is bad for my user experience, even though I loaded the script right when the landing page was visited. I visited Calendly embed demo sites and it seems that they have the same behavior.How can I prevent the loading experience ?

770
T
T
ThomasHagueCommunity Member
asked in API + Webhook Help
Calendly not Loading on Website on Mobiles (Apple, Samsung)

The calendly booking page doesn’t load on my website- www.thebreathcoach.co.uk The calendly integration loads on some mobiles but not others. Has anyone come across this before or have any ideas for a simple fix?This is my consultation booking page, and it’s where all my work comes in—so getting it working across all devices is important.Any advice would be much appreciated.Thanks,Thomas

290
T
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!

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

4107
G
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

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

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

3063
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

432
J
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!

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

671
C
Employee
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!

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

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

823
G
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!

19913
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

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

140
S
Terms & ConditionsCookie Settings