Skip to main content

Developer Community

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

285 Topics
hilaryyeg
Employee
hilaryyegEmployee
published in API + Webhook Help
New Event Type Management APIs

Hey developers! We’re excited to share that we’ve released a new set of APIs that let you create, update, and configure one-on-one event types, directly within your own interface.These endpoints are ideal for embedding the Calendly setup experience (with limited event type configuration) into your app or platform, so you can enable users to set up Event Types and streamline the onboarding experience.New endpoints:Create a new Event Type:POST /event_types Update an existing Event Type:PATCH /event_types/{uuid} List Event Type availability schedules:GET /event_type_availability_schedules Update Event Type availability schedules:PATCH /event_type_availability_schedules List user meeting locations:GET /locationNote: the Create/Update Event Type endpoints support one-on-one Event Types only, and are limited to basic field configuration (owner, title, description, duration, duration options, locations, visibility, color, locale). LinkedIn Premium Business used these APIs to power a new Calen

680
hilaryyeg
Employee
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.

7500
marion-calendly
Employee
L
lexosCommunity Member
asked in API + Webhook Help
Slack and Calendly Integration

Why can’t other members of my team see my Product Demos being booked in our Slack? The Calendly integration only works on an individual basis, and only I can see when product demos are booked for myself. I want my engineers to be able to see when product demos are booked in Slack as well, since they like to see the notification when it comes in.

51
David
Community Manager
A
Angela40647Community Member
asked in API + Webhook Help
Ongoing Errors Preventing Appointment Booking & PayPal Integration Issues

Dear Calendly Support,I am reporting a recurring issue that is significantly impacting my ability to use your platform. For the past several days, I have encountered the following problems: Booking Error: When attempting to schedule appointments, I receive a persistent error message stating, “Oops, something went wrong.” Client-Side Issues: Clients have also reported being unable to schedule appointments and are receiving similar errors. PayPal Integration: There are ongoing issues with PayPal payments not processing correctly. I have attempted to disconnect and reconnect my PayPal account, but the issue persists. These errors are interrupting business operations and client scheduling. Please advise if Calendly is experiencing outages or technical issues on your end. I would also appreciate being notified of any known service disruptions in the future.I look forward to your prompt assistance and a status update.  

61
David
Community Manager
C
Chris NijhofCommunity Member
asked in API + Webhook Help
Hide cookie banner in Embed, but still shows cookie banner..

Hey! I have this site where I want to embed a Calendy form. Sadly, once I embed the Calendy in my site with the cookie banner hidden, it still shows the cookie banner.  As you can see in the image, I have embedded the Calendy. But on the left it says “?hide_hdpr_banner=1” (this is directly from the “hide cookie banner” function when embedding my Calendy) What to do?

80
C
A
Avulreddy11686Community Member
asked in API + Webhook Help
How can I make few of the pre-filled fields (like name, email, or custom questions like customer id and brand ) non-editable in the Calendly booking form?

I’m on the Teams plan and using the inline widget. I prefill data like name, email, customer ID, and phone using query parameters in the URL (e.g. ?name=John&email=john@example.com).However, I noticed that even though these fields are pre-filled, the invitee can still edit them before submitting the form. Is there a way to make specific fields read-only or non-editable, especially custom questions like customer id, brand etc? Can I lock email or customer id or brand fields once pre-filled? This is a common need when the customer data is already known and verified. Allowing edits can lead to data mismatches or misuse.Any guidance or workarounds would be appreciated — thank you!

40
A
K
Kat80636Community Member
asked in API + Webhook Help
What field reveals the UUID that I should use API calls for scheduled_events?

I asked this 9 days ago but never got clarity on which field I am supposed to use.If I do this:curl --request GET \  --url "https://api.calendly.com/scheduled_events?organization=https://api.calendly.com/organizations/DERERCVFDYL7OLC&min_start_time=2025-01-01T00:00:00Z&max_start_time=2025-06-30T23:59:59Z" \  --header 'Authorization: Bearer eyJraWQiOiIxY2UxZTEzNjE3ZGNmNzY2YjNjZWJjY2Y4ZGM1YmFmYThhNjVlNjg0MDIzZjdjMzJiZTgzNDliMjM4MDEzNWI0IiwidHlwIjoiUEFUIiwiYWxnIjoiRVMyNTYifQ.eyJpc3MiOiJodHRwczovL2F1dGguY2FsZW5kbHkuY29tIi234523zUtYmQxMy03ZTBhNWIwNDk2MjciLCJ1c2VyX3V1aWQiOiJBSEhCWE5MVElEQVJMWkU3In0.jsvcK0mRkCdIF87BJ7UxVaHfQDWClDc-QEIl-PyYuXYVm95wDIWR4r-_Xw7IwLp_18Q-amd8BGmsa5deb0P9qw' \  --header 'Content-Type: application/json' There is no field called “UUID”. But I’m supposed to use a UUID if I then call the API for “invitees”.  Again, this is the JSON that comes back. It does not have a field called “uuid”.{  "calendar_event": {    "external_id": "",    "kind": "google"  },  "crea

842
K
G
Gabrielavale_1Community Member
asked in API + Webhook Help
How to Troubleshoot Calendly Webhook Failures for E-Commerce Automation?

Hi Calendly Community,I’m integrating Calendly webhooks with a Shopify store to automate booking confirmations (~100 bookings/day). Webhooks are set up, but some events fail to trigger.Setup: Calendly Premium, Shopify API, Zapier for automation.Steps Tried:Verified webhook URL and secret in Calendly. Tested Zapier triggers; some events miss. Checked logs, no clear error codes.Questions:What’s the best way to debug Calendly webhook failures? Any common issues with Shopify-Zapier-Calendly integrations? Tips for ensuring reliable webhook triggers?Thanks for your insights!

90
G
K
Karthikeyan20832Community Member
asked in API + Webhook Help
Integrate Calendly

I am building a react application where I will have Two Main Organisations ( for usecase ). Each user should be a host to create interviews with the members under that particular User. For Creating interviews, I need custom durations where I will have a form to enter date, start time and end time. After submitting this, Can this be sent to calendly to add the invitees under this organisation ( User ) and generate an interview.Also I want to list interviews, Cancel and reschedule them, all should be one organisation Specific.Is this possible in Calendly, if so what plan should I get and what steps Should I follow ?

100
K
K
Kat80636Community Member
asked in API + Webhook Help
What is the UUID referenced in the API for scheduled_events?

I want to get a list of all of the people outside of our organization who have attended our events. If I do this:curl --request GET \  --url "https://api.calendly.com/event_types?organization=https://api.calendly.com/organizations/" \  --header 'Authorization: Bearer {hidden} \  --header 'Content-Type: application/json' Then I seem to get a list of all of the events, but the list is much shorter than it should be. How do I get a list of every event that we’ve done in the last 6 months? Once I have that, I would like to get a list of attendees. So I try this:curl --request GET \  --url "https://api.calendly.com/scheduled_events/3df748e3-6d1a-4ede-abcd-39b1de2c17ca/invitees?organization=https://api.calendly.com/organizations/" \  --header 'Authorization: Bearer {hidden} \  --header 'Content-Type: application/json' I’m using a UUID I found in the responses to the first cURL call that I did above. But that does not work. I get “Resource not found.”  So what am I supposed to use for that UU

9514
J
K
Kat80636Community Member
asked in API + Webhook Help
400 error, invalid parameter on "organization" yet "organization" is required

If I go here: https://developer.calendly.com/api-docs/6rb6dtdln74sy-list-groups It says:“Query Parametersorganization, string, required, Return groups that are associated with the organization associated with this URI” The words “query parameters” normally mean a parameter that is in the URL, after a question mark, therefore I try: curl -vvv  --request GET --url "https://api.calendly.com/groups?organization=DCF*******7OLC" --header 'Authorization: Bearer {hidden}' --header 'Content-Type: application/json' But I get a 400 error. Since I’m using the -vvv flag, the full response is:  Note: Unnecessary use of -X or --request, GET is already inferred.*   Trying 172.64.146.81:443...* Connected to api.calendly.com (172.64.146.81) port 443 (#0)* ALPN, offering h2* ALPN, offering http/1.1* successfully set certificate verify locations:*  CAfile: /etc/ssl/cert.pem*  CApath: none* (304) (OUT), TLS handshake, Client hello (1):* (304) (IN), TLS handshake, Server hello (2):* (304) (IN), TLS handshak

582
G
R
Rhys58266Community Member
asked in API + Webhook Help
Help requested - Retrieving UUID based on invitee information URL

Hi there Does anyone know how to retrieve a Calendly UUID, based on an invitee URL through Calendly’s APIs? For context, I am using the Typeform / Calendly integration with Make. The URL captured in Typeform doesn’t appear to include UUID information.  Any help will be appreciated! ThanksRhys   

412
K
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!

811
J
Employee
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.

301
J
Employee
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

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

891
J
Employee
G
gb82102Community Member
posted in API + Webhook Help
Trouble Creating an Event via Calendly API – Need Help!

 Hello everyone,I'm trying to create an event (a meeting) through the Calendly API, following the official documentation. However, when I send a request to https://api.calendly.com/scheduled_events/, I keep getting a 404 error.Here’s what I’ve checked so far:✅ Using a POST request with the required payload✅ Ensuring my authentication token is correct✅ Double-checking the API URL and version✅ Tried testing with https://api.calendly.com/users/me (authentication works fine)Has anyone else faced this issue? Any suggestions on what might be missing or how to fix it? Would appreciate any insights!Thanks in advance! 

621
J
Employee
H
Hossam12408Community Member
asked in API + Webhook Help
Help with website code

i want to ask question why when i insert the code in my website in the first image look like this and how to make look like the second one  

391
J
Employee
Jim Stockman Easyvest
Jim Stockman EasyvestCommunity Member
asked in API + Webhook Help
hide_gdpr_banner=1 for Cookie banner does not seem to work anymore

Greetings everyone, We use this option in the mobile app to hide the cookie banner, unfortunately, this option does not seem to work anymore. Is this isolate or did other people report this issue ?I was able to replicate this issue by simply appending “<event_url>?hide_gdpr_banner=1” to an event URL. Could the Calendly team take a look at this ? We operate from Belgium if that can help.

812
Jim Stockman Easyvest
J
Joshua13266Community Member
posted in API + Webhook Help
Request: API Endpoint to GET Poll Responses

 I’m reaching out to request a critical feature for Calendly’s API: an endpoint to get/retrieve poll data. 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 workflows in the financial industry where meetings need to be seamless and easy -- often requiring our internal users to leverage multiple systems to schedule, log, and execute the meeting. Currently, Calendly’s API (as of 29-Apr-2025) does NOT allow us to fetch meeting poll results, so there is no way to determine which events are ready to be scheduled across hundreds of scheduled meetings. This limitation causes friction:Clients expect instant scheduling once availability is confirmed. Scrolling through hundreds of meetings and emails to determine which are ready for scheduling takes significant time, leading to drop-offs and lost business. In competitive markets, delays in scheduling can result in clients choosing faster alt

472
J
S
Saurabh20301Community Member
asked in API + Webhook Help
Does Calendly API support updating a user's default availability schedule directly

Does Calendly API support updating a user's default availability schedule directly?

120
S
J
Jerlyn76144Community Member
asked in API + Webhook Help
Is there a master API key?

I have a use case where I want to partner with local restaurants and offer a Book A Table feature via my app. Is there a way I can use a single ‘master’ API key to access the individual calendars of my partner restaurants and create bookings via the API? 

291
J
Employee
M
MBOCommunity Member
asked in API + Webhook Help
Identify Event name

I am trying to create an automation. When a person book a time in my Event page, I sent this information to Albato, an automation tool. As I have 2 event pages, one called Interview and the other Strategy Session. Which variable should I use to identify the Event name? Even though I am using the Event variable as you can see the image, it is not working. So, I believe this is not the correct variable to be using. The name is correct but the Event this not to be the correct variable.Does anyone know which variable is the correct one to be used to identify the Event Page?Thank you! 

701
J
Employee
J
João BenteuCommunity Member
asked in API + Webhook Help
How to use Calendly API V2 to schedule events via WhatsApp API?

Hi everyone,I’m working on an integration where I need to use the Calendly API V2 to schedule events, and I plan to do this through a WhatsApp API. Could anyone provide guidance on how to authenticate and interact with the Calendly API to create new events? Specifically, I want to allow users to schedule meetings directly via WhatsApp.Any advice or example code would be greatly appreciated!Thank you in advance!

391
J
Employee
R
Randy65405Community Member
asked in API + Webhook Help
Calendly + JIRA Integration (formatting date/time) - Need Help!

We just migrated to Calendly API v2 and are having issues with formatting the date/time fields.In particular, I’m using the start_time api field. There is no more “pretty” version of the start_time api field, so we need to format it in JIRA automation. I noticed, we get the date/time value in the start_time field as “2025-06-25T05:00:00.000000Z” (for example). However, in the JIRA documentation, JIRA is expecting the date/time field as “2020-08-18T02:40:37.0+0000” (for example). Because of this, the smart value format operations in JIRA automation do not recognize the date/time format therefore will not work. Has anyone found a solution to this issue?

221
J
Employee
Terms & ConditionsCookie Settings