Skip to main content

Developer Community

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

207 Topics
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!

3382
A
10 months ago
C
Craig83627Community Member
asked in API + Webhook Help
Calendly pop up stopped working

I embedded a Calendly popup on the home page of my Wordpress.org site a few weeks ago. It worked great for a while but now it’s morphed into a static tiny banner at the top of the page and it no longer opens the calendar (link is broken). I’m no HTML wiz, but was hoping someone could tell me how to fix it, or if too complicated, at least how to remove the banner.  Thanks.

1511
tcampb
Employee
10 months ago
M
Mandy47545New Community Member
asked in API + Webhook Help
Round Robin Meeting Links

I no longer have access to multiple round robin meeting links that I previously owned. Although I'm not currently a host within these links, I used to own them, allowing me to make edits and add participants. However, I've lost access, and I'm seeking guidance on how to regain control. How can I restore my access to these links?

2382
E
10 months ago
J
jas35105Community Member
asked in API + Webhook Help
Sorting fetched events based on "updated_at"

When using the following API end point https://stoplight.io/mocks/calendly/api-docs/395/event_typesfor fetching the List Of User's Event Types we have the option to sort and fetch the events on the basis of name using the sort option in the query parameters as mentioned here https://developer.calendly.com/api-docs/25a4ece03c1bc-list-user-s-event-types sortstringOrder results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values. Supported fields are: name. Sort direction is specified as: asc, desc.Default:name:ascExample:name We see that there is no other option we can pass. Is there a way we can fetch the events based on the update_at of an event in descending order?FYI: We are integrtating calendly in our CMS app, where we are making request to calendly to list user's events. It gives default 20 events sorted by NameThis will be not useful if user has multiple events and hence looking for a way to fetch latest updated events of user.

2903
marion-calendly
Employee
10 months ago
H
Himanshu53136Community Member
asked in API + Webhook Help
Calendly Oauth 2.0 connection -> Need client id, secret etc

HiI want to Integrate Calendly with Vertical CRM (ZOHO CRM application) so there are some values I need from calendly for the Integration. Please refer the screenshot belowCan you help me finding Signup URL, Refresh Token URL, Access Token URL, client id and secret etc. for my account 

5773
N
Employee
10 months ago
J
jas35105Community Member
asked in API + Webhook Help
Fetching "Users event types"

I wanted to understand why while sending a request to list “Users event types” the default number of events that can be fetched is 20 and the maximum is only a 100? Is there a specific reason behind this?I am talking about using the following end point to fetch the user details https://stoplight.io/mocks/calendly/api-docs/395/event_types

1051
marion-calendly
Employee
10 months ago
marion-calendly
Employee
marion-calendlyEmployee
posted in Developer FAQ
Embed: I am not receiving parent window notifications/I cannot hide the cookie banner

When initializing a Calendly embed with widget.js, our script adds two parameters to the iframe embed’s URL. The presence of these two parameters will allow the booking page to ‘behave’ like an embed.The parameters that our script adds are embed_domain and embed_type.When the parameters are included, the booking page will:show a transparent background behind the booking container instead of a light background, allow the option to hide the cookie banner and cookie preferences, and send notifications to the parent window with window.postMessage().There are a few reasons that these parameters can be missing from your embed:When loading an HTML file in your browser directly from your computer’s local files, embed_domain will be missing. (Note: loading a localhost page will populate the domain parameter - only pages opened directly will be impacted.) Loading an embed in a WebView can also sometimes result in embed_domain being missing, so you may need to add this manually to the URL. If you

3720
marion-calendly
Employee
11 months ago
K
kiran13Community Member
asked in API + Webhook Help
Setting Up for Cleint

I am individual who is helping small business vendor to setup the booking appointment app for them and would like to extend it for others. What is the best best way to setup for someone since I would like to setup everything for them by just configuring app for them with email and phone number.. 

841
Kelsi
11 months ago
F
FCI53621Community Member
asked in API + Webhook Help
UTM parameters for a scheduled event on calendly

I am using this API endpoint to get calendly events that were scheduled "https://api.calendly.com/scheduled_events" for one day before current day's date, but I am not able to fetch the UTM parameters related to that scheduled event from that calendly API endpoint, so is there a way to get UTM parameters for a scheduled event in calendly through API?

3961
marion-calendly
Employee
1 year ago
MrKennedy
MrKennedyCommunity Member
asked in API + Webhook Help
Router form responses - possible to delete them?

Hello,The default Routing response analysis is very nice.  My use case with Routing Forms, however, involves a lot of testing.  I’d like the ability to remove these test responses from the client response analysis.Easy enough to export and clean up the data, but I’d like to be able to simply delete these test responses once a routing form is deployed (or as it gets updated and tested).I see the routing form submission GET endpoints in the API, but no DELETE endpoint.I see no option in the Routing Forms GUI to select and delete responses.Are we NOT able to manage these Routing responses within Calendly at all?Thanks - would be nice to just know one way or the other for certain!

1833
Kelsi
1 year ago
S
SVB76154Community Member
asked in API + Webhook Help
Tracking Form Submission From Two Different Forms

I have two separate Calendly forms. One will be tracking leads from a particular source (these submissions will only be coming from a specific ad network), and the other submissions will be coming from all other sources on the site. I want these to be tracked separately. I have the Calendly GA4 integration set up on the site.  How would I go about creating separate conversion events for them in GA4?

1641
R
Employee
1 year ago
marion-calendly
Employee
marion-calendlyEmployee
posted in Developer FAQ
Why am I not receiving webhook data/how does a webhook become disabled?

If you are not receiving webhook data, it is possible that your webhook has become disabled or is in the process of becoming disabled because Calendly cannot successfully send a POST request to your server.When you call the get webhook subscription endpoint, the state will indicate whether the webhook is active or disabled. If the webhook is in the disabled state, you will need to delete it and create a new webhook after resolving any server issues that would cause this (see further below for more details).You can also reference retry_started_at to see the last time Calendly needed to start retrying because the POST request was not successfully received by your server. How does a webhook become disabled?If the URL that you are using for your webhook subscription returns non-2xx responses or if the connection times out, the retry process will start. Calendly will continue to try to deliver the data for 24 hours with an exponential back-off that makes attempts less and less frequently. A

5930
marion-calendly
Employee
1 year ago
marion-calendly
Employee
marion-calendlyEmployee
posted in Developer FAQ
What value do I pass in the 'user' or 'organization' parameter?

When calling Calendly API endpoints, you will sometimes be required to include a user and/or organization value. For example, the list events endpoint requires that you pass either a user or organization parameter depending on the scope you’d like to request and the create webhook subscription requires the organization and optionally the user to be passed in the body. But what are those values and how do you get them? The value you will need to pass is the user or organization URI.The easiest way to get these values is to call the get current user endpoint. The user URI can be found in uri and the organization URI can be found in current_organization.If you are using OAuth, these values will also be contained in the response when you get an access token. The user URI will be provided in owner and the organization URI will be in organization.Please note that you will need to pass the entire URI, not just the UUID portion. We recommend working with and saving entire URIs because UUIDs wi

3230
marion-calendly
Employee
1 year ago
L
liang-leapinCommunity Member
asked in API + Webhook Help
date is supported only when type is 'date'

I am having issues with the Share API, I have the following payload:{ "event_type": "https://api.calendly.com/event_types/5465e424-3294-4fb3-9de5-46a209a470fe", "name": "30 Minute Meeting", "duration": 60, "period_type": "fixed", "start_date": "2023-12-10", "end_date": "2023-12-15", "max_booking_time": 300, "hide_location": true, "location_configurations": [ { "location": "123 Abc St.", "additional_info": "Example additional information", "position": 0, "kind": "physical" } ], "availability_rule": { "rules": [ { "type": "wday", "wday": "sunday", "date": "2023-12-11", "intervals": [ { "from": "07:00", "to": "11:00" } ] } ], "timezone": "America/New_York" }}But I keep receiving:{ "details": [ { "message": "date is supported only when type is 'date'", "parameter": "date" } ], "message": "The supplied parameters are invalid.", "title": "Inv

4436
A
Employee
1 year ago
N
Employee
NirajEmployee
posted in Developer FAQ
Why is an organization URI required when using the user scope in webhook?

 An organization URI value is needed with a user-scoped webhook because a user can have multiple organizations associated with their data in Calendly, such as when they had their personal Calendly account before they were a member of an organization or after they leave an organization. As such, the organization is needed to confirm the specific user data that should be returned.

1580
N
Employee
1 year ago
N
Employee
NirajEmployee
posted in Developer FAQ
Can I cancel or reschedule an event through the API?

 Yes, to cancel an event via the API, you can send a POST request to the cancel event endpoint.At this time, there is no API endpoint that supports rescheduling an event or invitee, however the cancel and reschedule URLs are on the invitee resource.However, the cancel and reschedule URLs can be found on the v2 API webhook payload as well. You can see an example of the payload here.These URLs are always inserted at the bottom of calendar events or email confirmations, but they are available on the API to be more easily retrievable so you can place them wherever you want in the app that you are building.Please note that cancel event endpoint can be used to cancel an event, including a Group event, but not an individual invitee in a Group event.

9000
N
Employee
1 year ago
N
Employee
NirajEmployee
posted in Developer FAQ
Can I create or manage an event type through the API?

 At this time, our API endpoints do not support creating or managing event types. To manage an event or event type, users will need to visit their Event Types page within their Calendly account.

990
N
Employee
1 year ago
L
LemonadeLXPCommunity Member
asked in API + Webhook Help
Issues with embed

Hello.Just recently, the embed instructions noted here have stopped working:https://help.calendly.com/hc/en-us/articles/223147027?tab=advanced#3 Using the invocation code: Calendly.initInlineWidget({                url: 'https://calendly.com/d/FORMIDREMOVED?hide_gdpr_banner=1',                parentElement: document.getElementById('calendly-modal-body'),                prefill: {}            }); Spawns a request to Calendly that ultimately returns this response Age: 9545cf-cache-status: DYNAMICcf-ray: 82d4ad0a0b103705-YYZContent-Encoding: brContent-Type: text/html; charset=utf-8Date: Tue, 28 Nov 2023 18:29:21 GMTLast-Modified: Tue, 28 Nov 2023 15:50:04 GMTServer: cloudflareStrict-Transport-Security: max-age=31536000; includeSubDomains; preloadVary: Accept-Encoding, OriginVia: 1.1 192b5dfe0d3306c6761973a7786a01d4.cloudfront.net (CloudFront)x-amz-cf-id: qnDkzkCQ-DxfUc_z4Pp1jZA24f5UoczK1oqvza1rvhS0u98DWrPW4A==x-amz-cf-pop: YUL62-C2x-amz-version-id: EVin17i.0_5u4mmzATuQGsDtuQywgDL1x-cache:

5253
Kelsi
1 year ago
P
PluspuntCommunity Member
asked in API + Webhook Help
IMAP

my email is IMAP and  does not work. ANy way to work around it?

4595
myabrownn
1 year ago
U
Ulugbek73678Community Member
asked in API + Webhook Help
The question arises, it asks the URI of the organization or the URI of the user, where can I get them?

Hello, I am delaying the integration with make (integromat). The question arises, it asks the URI of the organization or the URI of the user, where can I get them? I looked everywhere and couldn't find the answer.

972
jillian
Community Manager
1 year ago
P
Pablo40376Community Member
asked in API + Webhook Help
Accessing calendly events data via API/webhook

Hi!We’re trying to send calendly data to our Databricks workspace to analyze event data and build dashboards with it.Would it be possible to access data from a calendly API (or an outbound webhook) to get calendly data into Databricks?

991
A
Employee
1 year ago
S
samtukeCommunity Member
asked in API + Webhook Help
How to track attribution of sales bookings via events (UTM sucks)

Hi All, we need to be able to attribute sources of sales call bookings made via Calendly. Calendly seems to not be built for this.Use case:In reality we have 1 type of sales call, and ideally 1 event type for it But there are many routes via which prospects can land on that event We need to determine which routes / sources of bookings perform best Ideally we’d have 1 event type with a breakdown of all referrers or sources of bookings Ideally that would be exportable to CSV. But if the data is accessible another way it’s OKProblem with Calendly:Calendly allows only 1 URL per event booking page. This is a major constraint because we can’t have different URLs to attribute bookings to different sources. Calendly does support UTM codes, but as we all know UTM are one of the best ways to make a good URL long and unusable. Specifically: several sources of bookings are via email or other places that huge long ugly URLs are not workable. URLs like this are not practical for popping into a sales

2912
S
1 year ago
D
Dennis30227Community Member
asked in API + Webhook Help
Is it possible to embed the "Scheduled Events" view

I know that the scheduling page can be embedded somewhere else.Is it also possible to embed the “Scheduled Events” view (My Calendly > Scheduled Events)?I would like for our colleagues to have an overview of their scheduled events within a website.

2533
Kelsi
1 year ago
A
AndreasBCommunity Member
asked in API + Webhook Help
Why does the webhook callback signing key change with every call as opposed to using mine?

I successfully used the webhook callback API with signing_key verification a few days ago. But now, for some reason, the signing key changes with every callback making me reject the call.What could possibly be the cause? I did follow the docs @ https://calendly.stoplight.io/docs/api-docs/c1ddc06ce1f1b-create-webhook-subscription Below is my successful webhook I created:    "collection": [        {            "callback_url": "https://TO_SOME_PLACE/",            "created_at": "2023-11-14T18:45:52.610226Z",            "creator": "https://api.calendly.com/users/USER_ID",            "events": [                "invitee.created",                "invitee.canceled",                "invitee_no_show.created"            ],            "organization": "https://api.calendly.com/organizations/ORG_ID",            "retry_started_at": null,            "scope": "user",            "state": "active",            "updated_at": "2023-11-14T18:45:52.610226Z",            "uri": "https://api.calendly.com/webhook_

1763
A
Employee
1 year ago
A
AndreasBCommunity Member
asked in API + Webhook Help
Failing to retrieve auth token after successful authorization with OAuth API

I am currently trying to integrate with the latest OAuth API but run into a problem when trying to obtain the token. I was able to make a successful authorization request to receive the code needed. But when I try making the call to https://auth.calendly.com/oauth/token, I receive the following error:bad request: [json.exception.parse_error.101] parse error at line 1, column 1: syntax error while parsing value - invalid literal; last read: '<'I am following the API specs @ https://developer.calendly.com/api-docs/be9b32ef4b44c-get-access-token. I further can confirm that my credentials are valid because when I supply invalid data, e.g., wrong client_id, I am getting the expected error message for wrong credentials. Below is my code that I am currently using for the call in Python.What am I doing wrong? Thank you in advance,-Andreas def callback(self, request, *args, **kwargs):# Extract the authorization code from the callback URLauthorization_code = request.GET.get('code') # Exchange

7285
A
Employee
1 year ago
Terms & ConditionsCookie Settings