Skip to main content

Developer Community

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

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

4800
marion-calendly
Employee
1 year ago
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?

1864
P
6 hours ago
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 

00
W
12 hours ago
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. 

111
F
2 days ago
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 

111
M
Employee
5 days ago
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

1773
S
5 days ago
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": { "

60
M
6 days ago
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 ?

61
David
Community Manager
7 days ago
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!

2685
L
11 days ago
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!

90
R
12 days ago
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.   

172
K
13 days ago
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?

301
A
Employee
14 days ago
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

4869
A
18 days ago
T
Tuan78671Community Member
asked in API + Webhook Help
Refresh token

Hi, how to refresh access token with refresh token, i can not find it in document 

491
A
Employee
18 days ago
Alexander
AlexanderCommunity Member
asked in API + Webhook Help
Invisible padding/margin around Calendly form & inside iFrame

Hello,with the embedded Calendly version and data-resize=”true”, it’s now possible to set the correct height automatically. Thank you very much for it.Unfortunately, there is still a huge invisible padding/margin around the calendar inside the iFrame. How it is possible to remove it?I used the negative padding hack here on my website: https://www.shop-studio.io/en/contact. The solution is “ok” but not responsive in every case (see mobile). As you can see, the loading spinner is performing a “layout shift” during loading.Thank you in advance! 

350
Alexander
28 days ago
A
AdamCommunity Member
asked in API + Webhook Help
Any support for a test or development environment?

Hi,I’m developing some webhook integrations to consume invitee.* events.We have both a dev and a prod environment and I was wondering if you have any guidelines, best practices, or support for how to set up the dev environment. The goals would be:Have dev and prod share as much as possible - ideally, the only difference would be how they are configured (signing keys, auth keys). Not allow any production data into devThanks!

4034
David
Community Manager
28 days ago
I
Info78063Community Member
asked in API + Webhook Help
The email field should have an option to be prepopulated and read only for security purpose

Hi,I’m using your webhook that react the scheduling of my users.I pre fill via the URL the name and email of the user.But if one user decide to change the email for something else, eventually it can crash the app. I can find a way around with an “if email exist” statement, but if the user decide to put an already existing email that is not his, the webhook will still process it and change things in the database of the user’s mail used.There should be a way to go around that.Thank you

371
T
30 days ago
I
Indy81725Community Member
asked in API + Webhook Help
Calendly embed loading twice

Hello,I have embeded our Calendly on a dedicated page on our website via an iframe. Everytime I open the page, the Calendly loads a first time and then disappears for a second before loading again. So it essentially loads twice. It isn’t systematic, but I’d say this occurs 80% of the time. I cannot figure out what is causing this issue. Our website is a Wordpress that uses Elementor. https://www.indy.fr/routing-form-calendly-iframe/Thanks! 

401
Austin
Community Manager
1 month ago
A
AndryZiCommunity Member
asked in API + Webhook Help
Multiple widgets on one page. Feedback problems.

I have WordPres site. One of page of this site I have few Calendly widgets that clienst can choose by using Tabs. After the user submits a request using the widget, I take the response from the server and show them the date of the booked appointment in a popup window.https://monosnap.com/file/g1ixOsdIlSmRPGarW85fXKqaotXObphttps://monosnap.com/file/aTO58rgk1HtFrhYpBkGhBUjtANO3sBMy codewindow.addEventListener("message", function (event) { if (event.origin.includes("calendly.com")) { const data = event.data; if (data.event && data.event === "calendly.event_scheduled") { console.log("Event scheduled:", data.payload); const eventUri = data.payload.event.uri; const inviteeUri = data.payload.invitee.uri; // Getting event details via API fetchCalendlyEventDetails(eventUri, inviteeUri); } }});async function fetchCalendlyEventDetails(eventUri, inviteeUri) { try { const eventId = eventUri.split("/"

120
A
1 month ago
A
Adrian23326Community Member
asked in API + Webhook Help
How can I remove the section which would be used for the 'Cookies Settings' button?

I have turned off the cookie pop up on the inline embed but I believe the section for the cookies settings is still showing. This has caused some problems with the margins on the page when going between different breakpoints.  Is it possible to remove this from the embed to give more control of the sizing around it?Thanks  

230
A
1 month ago
N
NaregCommunity Member
asked in API + Webhook Help
calendly-inline-widget mobile view

Hello!We use a calendar on our wordpress (wpbakery) website, but we have a problem. On the mobile view of the website, the form has a very short height. How can we solve this problem?I have tried both data-resize=”true” and overflow-y: hidden !important;  but it didn’t work!https://wordpress-475423-4893252.cloudwaysapps.com/appointments/

371
N
1 month ago
S
SparkCleanCommunity Member
asked in API + Webhook Help
Event Type

Hey folks, how are you?Is it possible to update an event type via API? For instance, I have a webhook that sends me some data, and I would like to modify the event type to a dynamic duration so that when the client schedules an appointment in Calendly, it calculates the time interval and blocks the corresponding time slots.Example: 2 hours and 20 minutes. The client schedules the service at 5 PM, so I would block the calendar from 5 PM to 7:20 PM.

1003
Austin
Community Manager
1 month ago
S
smatteringsCommunity Member
asked in API + Webhook Help
I'm getting a Request failed with status code 404 after successful OAuth when I make an api request.

I am able to successfully retrieve a token from OAuth but am getting a “Request failed with status code 404” when I make an api request. Has anyone encountered the same?

110
S
1 month ago
P
Paulus74625Community Member
asked in API + Webhook Help
Booking meetings programmatically

Hi there,Does the API offer a way to book a meeting?If not, do you have an ETA for this important functionality? It’s hard to work around this missing feature.Paulus

1261
David
Community Manager
1 month ago
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.

331
K
1 month ago
Terms & ConditionsCookie Settings