How to get event type and user calendar availability data

Event Type Availability

Calendly users can retrieve information about availability for a specific event type when they generate and use a personal access token or OAuth token to authenticate requests to Calendly’s API. 

Use cases that can be achieved with this API:

• Take appropriate action based on available times for a given event type.

• Effectively share available meeting times from an external application to increase the probability of meetings being booked and enhance the invitee experience.

  • For example: 

    • Display specific available times when sending communications to invitees directly from external applications.

    • Include and share first 'X' available times.

To retrieve a list of available times for a specific event type within a specified date range:

1. Make a call to /event_types to retrieve a list of all event types (using the organization scope to get all event types across the organization or using the user scope to get all event types for a specific user). The endpoint will return a collection of event types with an event type  uri for each item in the array. 

2. Make a call to /event_type_available_times and pass the event type uri for the event type you would like to retrieve information about. Please note that start_time and end_time parameters are required, must be in the future, and cannot be a range greater than 7 days. 

User Calendar Availability 

Calendly users can retrieve information about the availability of users in their organization when they generate and use a personal access token or OAuth token to authenticate requests to Calendly’s API. 

Use cases that can be achieved with this API:

• Programmatically calculate total hours available for a given user for a given period of time. For example:

  • Total available hours

  • Total scheduled hours

• Build a custom ‘Calendar View’ for a given user. 

• View availability schedules and date overrides to determine if a user needs to open up more availability options.

To retrieve information about a specific user’s availability schedule and their busy times for a given period, make the following GET requests: 

To retrieve the availability schedules and date overrides for a specific user:

1. Make a call to /organization_memberships to return a collection of users in an organization which includes a user.uri for each item in the array.

2. Make a call to /user_availability_schedules and pass the specified user.uri .

To retrieve busy times for a specific user (based upon the connected calendars marked as “Check for Conflicts” in Calendly):

1. Make a call to /organization_memberships to return a collection of users in an organization which includes a user.uri for each item in the array.

2. Make a call to /user_busy_times and pass the specified user.uri . Please note that start_time and end_time parameters are required, must be in the future, and cannot be a range greater than 7 days.