Skip to main content

Developer FAQ

A few things we think you should know!

  • 10 Topics
  • 2 Replies
10 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.

4480
marion-calendly
Employee
11 months ago
C
CampaignAudienceBuilderAlexCommunity Member
asked in Developer FAQ
Height & Width Breakpoints, missing height limit + scrollbar

Hey there,I’m currently implementing a “book a demo”-landing page and can’t figure out how to properly embed my Calendly page.It’s a 2 column layout. Left column: content, right column: Calendly Widget. I figured out, that there is a certain threshold around 950ish pixels width where the widget jumps from desktop-mode (above that threshold) to mobile-mode (below threshold). Now I got the problem that in that mobile-mode the widget fully expands for all available time slots.I’d wish to limit this in max-heigth and get a scroll bar for the time options (only time options scroll, calendar view stays fixed). That behavior is available in “desktop-mode” (see 1st screenshots) but not in “mobile-mode”. How can I accomplish this?

1290
C
5 months ago
C
Christophe20085Community Member
asked in Developer FAQ
Can't hide event details on the embed

Hi I’m trying to hide the event details in my embed with the “hide_event_type_details=1” code but the infos still appear. Any guess on what’s not working ? Here’s the entire code copied on my website :<!-- Début de widget en ligne Calendly --><div class="calendly-inline-widget" data-url="https://calendly.com/EVENTLINK?hide_gdpr_banner=1?hide_event_type_details=1" data-resize="true" style="min-width:320px;height:700px;"></div><script type="text/javascript" src="https://assets.calendly.com/assets/external/widget.js" async></script><!-- Fin de widget en ligne Calendly --> 

2251
Austin
Community Manager
5 months ago
C
Christophe20085Community Member
asked in Developer FAQ
How can I display the Calendy widget in landscape mode on my landing page ?

Hi,Currently the Widget displays informations on top and the calendar below , and that create some unwelcomed scrolling. How can i make it horizontal : Title and infos in the left , and calendar on the right ? (at least for desktop)Thanks !

3241
Kelsi
6 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
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
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
Terms & ConditionsCookie Settings