Skip to main content

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 /location

Note: 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 Calendly integration that lets users add a “Book an appointment” button to their profile in just a few clicks.
​
Behind the scenes, the integration guides users to create a new Calendly account, set up a new Event Type, and configure the meeting location and availability – all within the LinkedIn Premium product.​​​​

 

You’ll find the full API documentation on the Developer Portal. Got questions or feedback? Drop them in the comment – we’d love to hear from you!

Thanks for that. For 

PATCH /event_type_availability_schedules

if I include a single date for an update, e.g. like this

{"availability_rule":{"timezone":"Europe/London","rules"::{"type":"date","date":"2025-08-04","intervals"::]}]},"user":"https://api.calendly.com/users/FFFFF","availability_setting":"host"}

to remove a specific date from the availability, it appears that this removes ALL other availability data for other dates. Following the call, there is a single date listed, and all others have been removed.

The same thing appears to happen when noting (actually positive) availability like this:

{"availability_rule":{"timezone":"Europe/London","rules"::{"type":"date","date":"2025-08-05","intervals"::{"from":"09:00","to":"17:00"}]}]},"user":"https://api.calendly.com/users/FFFFF","availability_setting":"host"}

Is that by design? In other words, if I am setting date-based availability, do I need to set ALL FUTURE DATES at once?

Thanks.

Updating rules via API does overwrite all existing rules for the event type. Ideally you would use the GET endpoint to retrieve the existing rules, modify, then pass all of the rules, including the modified rules, to the PATCH endpoint. Otherwise it is assuming that you want to replace the rules with just what you pass it, unfortunately you cannot update them one piece at a time.

Thanks for the reply ​@Clifton - appreciate it.

Reply


Need Help? Visit 'Get Help. Give Help.'
Terms & ConditionsCookie Settings