Skip to main content

Developer Community

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

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

4450
marion-calendly
Employee
11 months 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

371
T
Employee
16 hours 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! 

231
Austin
Community Manager
2 days 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?

833
Austin
Community Manager
2 days 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("/"

70
A
10 days 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  

100
A
10 days 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/

251
N
10 days 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.

583
Austin
Community Manager
11 days 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?

100
S
16 days 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

1091
David
Community Manager
17 days 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.

141
K
18 days ago
F
FreeYourMindCommunity Member
asked in API + Webhook Help
Cookie Alert

Hi,I’ve found that Calendly, when embedded on a website, is showing the “click to accept marketing cookies and enable this content” message.Setting “ hide_gdpr_banner=1” makes no difference.By displaying this modal message, you are forcing users to consent, before making a booking. Forced consent and linking consent with other matters both invalidate consent under GDPR, therefore you do not have a lawful basis for marketing cookies. All your tracking data is unlawful.This is a particular deal breaker for me because you’re preventing customers from booking, just so you can gather marketing data about my website.Please fix it quickly.Keith

180
F
20 days ago
P
Pat85164Community Member
asked in API + Webhook Help
Redirect issue: Unsafe attempt to initiate navigation for frame ... The frame attempting navigation of the top-level window is sandboxed with the 'allow-top-navigation-by-user-activation' flag, but has no user activation (aka gesture)

As the title suggests, we’re trying to redirect after booking is complete but it fails with the following error:Redirect issue: Unsafe attempt to initiate navigation for frame [URL] The frame attempting navigation of the top-level window is sandboxed with the 'allow-top-navigation-by-user-activation' flag, but has no user activation (aka gesture)We’re just using a standard Calendly embed, and it all appears to work apart from the redirect at the end.When I test using a simple HTML page, everything is fine. However this page is hosted on Framer, so I’m guessing there’s something in Framer that’s conflicting?You can see it in action here:https://recsites.com/uk/book-demo Any assistance is greatly appreciated.

120
P
22 days ago
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!

50
P
23 days ago
G
Glen44563Community Member
asked in API + Webhook Help
Issues Integrating Calendly API with My Website for Custom Booking Flow

Hi Calendly Community,I’m trying to integrate the Calendly API into my website to create a custom booking flow, but I’ve run into a few issues:When I use the API to fetch available time slots, the response occasionally returns empty, even though the calendar has availability. I’m receiving a 401 Unauthorized error intermittently, even though I’ve double-checked my authentication token and API key. The booking flow works fine in testing but sometimes fails to confirm bookings on the live site, displaying a “failed to process” message.Here’s what I’ve done so far:Verified that the API token is valid and has the correct permissions. Ensured my API requests comply with the documentation (e.g., correct headers and parameters). Tested the integration in a local development environment, where it works more consistently.Could this be related to rate limits, caching issues, or something else? Any insights or advice on making the integration more stable and reliable would be greatly appreciated!

800
G
25 days ago
S
Shaun23100Community Member
asked in API + Webhook Help
When rescheduling a meeting, not receiving any webhook data for new appointment times

I am working with the calendly webhooks, and I am successfully able to use invitee.created and invitee.cancelled.  But what about when a user reschedules a meeting?  I don’t see any event types for rescheduling, and when a meeting is rescheduled, it’s giving me a cancellation event, with a rescheduled: true in the event body, but it doesn’t seem to be sending me the new rescheduled date/times.  Am I missing something here?  The documentation for calendly doesn’t show a rescheduled webhook.  Wondering how to go about this :-)Thanks!

401
S
25 days ago
A
Aditya41343Community Member
asked in API + Webhook Help
How to Update a Custom Field in Salesforce When a Calendly Invite is Accepted by User?

Hi EveryoneI am working on integrating Calendly with Salesforce and need a way to automatically update a custom field on a Salesforce object whenever a new user is added to the organization in Calendly and he/she accepts the Invite. Here's the scenario:When a user accepts the Calendly invite, I need their unique Calendly ID and Email Address to be sent to Salesforce and updated in a specific custom field on a Salesforce object. Calendly ID should be the unique user identifier which is present in the scheduling URL of the new user. eg: calendly id which I am looking for is john-doe (slug) which is in scheduling url: https://calendly.com/john-doe Does Calendly provide any webhook or event that can notify Salesforce with the details I need, when an invite is accepted?

130
A
26 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!

2354
Y
29 days ago
R
rg83Community Member
asked in API + Webhook Help
Get paid events info

HiI need to send an invoice to my client when they paid for an event.I don’t find anything in API docs related to payment info.Can you help 

190
R
1 month ago
A
AndryZiCommunity Member
posted in API + Webhook Help
Can you add atributes for getting custom styles for form ?

Could you add an attribute that would help developers customize the form styles with their own CSS properties. Here is a simple way to implement it. <script src="https://assets.calendly.com/assets/external/widget.js" type="text/javascript"></script><div class="calendly-inline-widget" data-url="https://calendly.com/andry-heyreliable/30min?hide_gdpr_banner=1" style="height:700px;"  data-custom-css=”https://testsite.local/custom-styles.css”  ></div> Just simple `data-custom-css`  will help to change styles of widget by having more strong priority 

272
A
1 month ago
D
Delta85444Community Member
asked in API + Webhook Help
Create Webhook failed

 I want to create a webhook that listens to all the events associated with my organization. Below is my request object.var requestBody = new WebhookSubscriptionRequest{    url = "https://00f9-2001-ee1-df19-e6e0-a953-99e6-1ea6-928c.ngrok-free.app/Calendly/Callback",    events = new string[] { "invitee.created", "invitee.canceled" },    scope = "organization",    organization = orgUrl,    signing_key = "ABC",}; Then I got this error:  But in the document, it looks like the group and user parameters are optional. Am I missing something?

562
D
1 month ago
A
AndryZiCommunity Member
asked in API + Webhook Help
Calendly API How to add custom fields outside the widget?

Is it possible to include any custom fields like the one in the image in the Calendly form request that will display them in the body of the emails that the client and site owner receive?I read in the documentation about new fields, and questions that come with iframe But this is not quite it. My task is to add my OWN fields when sending the form. Is it posiable in some JS code ?

520
A
1 month ago
A
Austin33624Community Member
asked in API + Webhook Help
I keep getting a error when trying to test the API

I just signed up for Calendly and am testing it out. There seems to be an issue when I create the Personal Access Token and use it for the API connection. Here is what I am getting returned: 401 Unauthorized {"title": "Unauthenticated","message": "The access token is invalid"} I am trying to test it within the docs, and have also tried testing through Postman, etc. Everywhere is showing the same error.  For security, I replaced the personal access token. Thank you for your help in advanced.

8858
S
1 month ago
A
Adam40862Community Member
asked in API + Webhook Help
Webhook not working

I have an integration with an app I’m developing for scheduling meetings. My app checks the Calendly API and verifies the calendly subscription still exists everytime when it starts. I’m running NGROK to forward requests locally currently with the subscription and I can no longer see requests from Calendly. I confirmed the subscription is still there. I just tested another webhook for an esignature API I also have setup and it’s working and forwarding. The calendly one is broken and doesn’t forward (invitee.created in this case).It was working before, I have no network issues so I assume this is a Calendly problem. I can see the token shows last access date so auth/connect is fine. I am just not receiving payloads anymore. I last saw this working a few days ago. 

1982
J
1 month ago
T
Travis16241Community Member
asked in API + Webhook Help
GDPR Cookie banner still loading on embedded reschedule popup widget even with GET param "hide_gdpr_banner" set to true

I’m running into an issue when trying to suppress the GDPR banner for rescheduling events using the embedded widget integration.Calendly documentation indicates the GDPR cookie banner can be hidden using the “hide_gdpr_banner” GET parameter when calling the embedded popup integration. However, the banner still appears when I have the parameter set in the URL. The parameter is working correctly for embedded popup widgets to create an event and to cancel an event, but doesn’t work for rescheduling.Is this a bug in the Calendly integration?

806
David
Community Manager
1 month ago
Terms & ConditionsCookie Settings