Skip to main content

Developer Community

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

279 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

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

7300
marion-calendly
Employee
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

6512
K
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

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

100
K
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   

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

341
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

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

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

451
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  

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

482
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

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

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

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

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

201
J
Employee
Q
quad-researchCommunity Member
posted in API + Webhook Help
New Feature Request - Customizable Query Code Autofills

We advertise the link to our Calendly on another website (which we have no control over). When a person clicks on this link, certain query codes are attached to the link.It would be extremely helpful if we could use this information to autofill the answers to some of our questions when the person is signing up for a time slot.

181
J
Employee
D
David44266Community Member
posted in API + Webhook Help
Feature Suggestion - customizable field names for url parameters

When prefilling Calendly forms, the url parameters codes are not customizable (i.e., first name is first_name, custom question 1 is a1).  It would be great if we could set the url field code dynamically for integration with vendors who push data in a set format (yes, requested the opposite with those vendors as well).  For instance, instead of using “a1” as the field parameter, allow user to change it to a custom name.

121
J
Employee
B
Blake84347Community Member
asked in API + Webhook Help
Updating SAML Certificate Hybrid Entra Environment

Good day,I have created a new SAML certificate in Entra and I am trying to figure out the best method to update it in the Calendly Admin center or if a brand-new connection to have to be established? I could not find an article on this so I was wondering if anyone would know the answer to this or if anyone knows how to get ahold of technical support, the chat option is not available for some reason. Thanks! 

161
J
Employee
J
JohanCommunity Member
asked in API + Webhook Help
Multilingual Form, Hidden Fields & Host Notifications – Best Practices?

Hello Calendly Community, I’m reaching out for guidance on three specific challenges I’m currently facing:  Multilingual Support My website operates in four languages (EN, FR, DE, IT), and I’d like to use a single Calendly booking form to handle all requests, while adapting the experience to the visitor’s language. Hidden Fields for Tracking I would like to pass hidden parameters in the booking URL (such as language and source/channel) and capture them with each booking. This would help us identify where the booking originated (e.g. homepage, blog, pricing page). Host Notifications with Hidden Field Data Ideally, the host receiving the booking should see those hidden parameters in the email notification, to better prepare for the call.   Could anyone share how they’ve approached this setup—or if it’s even fully possible within Calendly today (and if so, which plan is required)?Any advice or best practices would be greatly appreciated! Thank you in advance, Johan

311
J
Employee
M
Md23562Community Member
asked in API + Webhook Help
Embed Scroll Issues

https://www.calendly-embed.com/embed-options#inline why it’s looking like scrolling type? this is not good at website. does anyone know how can i sloe this problem?I want actually like the below format in our website. when  i want to use inline embaded option not working in my website like the below format. 

191
David
Community Manager
D
Denise85445Community Member
asked in API + Webhook Help
Wrong times showing on appointment email

A client’s email showed the incorrect time slotThe email showed 1:15 pm when it shows on my calendar 9:15 am

133
David
Community Manager
Terms & ConditionsCookie Settings