Skip to main content

Developer Community

Looking to use Calendly's API or build integrations? Developer Community is here to help.

228 Topics
marion-calendly
Employee
marion-calendlyEmployee
published in Developer FAQ
Developer Getting Started Resources

If you’re getting started with the Calendly API or advanced embed, the Developer Portal is the best place to start!Getting started - an overview of our APIs and the different ways you can authenticate. Create a developer account - instructions on making an account to create and manage OAuth credentials. API Reference - our up-to-date API reference, including a full list of available endpoints. API use cases and API recipes - some ideas and tutorials related to common API uses. Release notes - stay up to date with new releases and use our RSS or Atom subscription options.We also have some embed Help Center articles that are helpful to developers.Advanced embed - an outline of our advanced embed code, including a function to manually initialize an inline embed. Source tracking with your Calendly embed and UTM parameters - a great reference for passing UTM parameters to an embed.

5170
marion-calendly
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? 

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

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

15712
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

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

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

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

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

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

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

2816
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

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

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

130
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 

140
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 

490
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 

561
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

2143
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": { "

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

401
David
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!

3375
L
R
rcobCommunity Member
asked in API + Webhook Help
Optimizing event_type_available_times request

Hi all,I’m working on an API integration for a website, and even though (for now) it’s working correctly, I’m wondering if I’m there’s a better way to get a user availability for an event type to display in a calendar component.Since `event_type_available_times` has a 7-day date range limit, I’m currently doing 4 consecutive calls to fetch the availability for each month. The problem is that it’s incredibly slow, so when the user first opens up the calendar, or then switches to the next month, it’s taking around 5-7 seconds to complete all the requests and display the days with availability.Is there a more optimized/faster way to do this? Thank you!

190
R
K
KP06012025Community Member
asked in API + Webhook Help
WordPress Calendly Display Help

Hi,When I embed Calendly in my WordPress Website, all of the available dates are blacked out. Can any please help me figure out how to resolve this? Please see image below.   

432
K
A
alkj1Community Member
asked in API + Webhook Help
Calendly subscription for Webhooks?

Hi, I want to authorize users on my website and get their calendar events.Does each user need to have a standard plan (or higher) or will my paid subscription work?

411
A
Employee
A
AlterCall30248Community Member
asked in API + Webhook Help
Serious issue in "List Events" endpoint: "page_token" is not working

Hello Calendly Developer Community,I'm encountering a critical issue with the "List Events" endpoint in the Calendly API, specifically related to the pagination functionality. I'm hoping to get some insights or assistance from the community.Here's a detailed description of the problem:Initial Request Success: The first API call to the "List Events" endpoint to retrieve 100 events works as expected. Pagination Issue: However, when I attempt to make a subsequent call using the page_token parameter (which I received from the initial request) for the next set of events, the API returns a 400 error. This suggests a problem with the pagination implementation. Environment: I've encountered this issue consistently in both Python and Make (Integromat) environments. Comparison with Other Endpoints: To isolate the problem, I've tested pagination with other endpoints, such as the one used for routing forms, and it worked correctly there. This indicates that the issue seems specific to the "List Ev

5219
A
Terms & ConditionsCookie Settings