Cal.com

Scheduling, bookings, availability, teams, and organization management

OAuth238 native toolsIcon needs-review

This catalogue entry describes the current repository definition. Availability, scopes, and production readiness should be confirmed during private-beta onboarding.

Native tools

POST

cal_com_booking_attendees_add_attendee

Add a new attendee to an existing booking by its UID. Seated Events: This endpoint does not support seated event bookings. For seated events, each attendee must be added by creating a new booking for the same event type and time slot via POST /v2/bookings. Attempting to add an attendee to a seated event booking will return a 400 error. Side effects: - The booking's attendee list is updated in the database - The calendar event is updated on connected calendars (Google Calendar, Outlook, etc.) to

/v2/bookings/{bookingUid}/attendees

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
body	object	required	—

GET

cal_com_booking_attendees_get_booking_attendee

Retrieve a specific attendee by their ID for a booking identified by its UID. The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error. If accessed using an OAuth access token, the BOOKING_READ scope is required.

/v2/bookings/{bookingUid}/attendees/{attendeeId}

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
attendeeId	number	required	—

GET

cal_com_booking_attendees_get_booking_attendees

Retrieve all attendees for a specific booking by its UID. The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error. If accessed using an OAuth access token, the BOOKING_READ scope is required.

/v2/bookings/{bookingUid}/attendees

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

POST

cal_com_booking_guests_add_guests

Add one or more guests to an existing booking. Maximum 10 guests per request, with a limit of 30 total guests per booking. Rate Limiting: This endpoint is rate limited to 5 requests per minute to prevent abuse. Seated Events: This endpoint does not support seated event bookings. For seated events, each guest must be added by creating a new booking for the same event type and time slot via POST /v2/bookings. Attempting to add guests to a seated event booking will return a 400 error. Email Notific

/v2/bookings/{bookingUid}/guests

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
body	object	required	—

PATCH

cal_com_booking_location_update_booking_location

Updates the booking location in Cal.com and updates the corresponding calendar event via the organizer's connected credentials. For integration locations (e.g. Zoom, Google Meet, Cal Video), the endpoint also provisions a conference link. Attendees are notified of the location change by email. The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error. If accessed using an OAuth access token, the BOOKING_WRITE scope is required.

/v2/bookings/{bookingUid}/location

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
body	object	required	—

GET

cal_com_booking_routing_trace_get_booking_routing_trace

Retrieve the step-by-step routing trace for a booking identified by its UID. Shows how the booking was routed through routing forms, CRM lookups, and host selection logic. Returns presented (human-readable) trace steps grouped by routing round, along with the routing form submission if one was used. If no routing trace exists for the booking, empty steps and groups are returned. The cal-api-version header is required for this endpoint. If accessed using an OAuth access token, the BOOKING_READ sc

/v2/bookings/{bookingUid}/routing-trace

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

POST

cal_com_bookings_confirm_booking

The provided authorization header refers to the owner of the booking. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKING_WRITE scope is required.

/v2/bookings/{bookingUid}/confirm

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

POST

cal_com_bookings_create_booking

POST /v2/bookings is used to create regular bookings, recurring bookings and instant bookings. The request bodies for all 3 are almost the same except: If eventTypeId in the request body is id of a regular event, then regular booking is created. If it is an id of a recurring event type, then recurring booking is created. Meaning that the request bodies are equal but the outcome depends on what kind of event type it is with the goal of making it as seamless for developers as possible. For team ev

/v2/bookings

1 parameter

Param	Type	Required	Description
body	object	required	Accepted variants: CreateBookingInput_2024_08_13, CreateInstantBookingInput_2024_08_13, CreateRecurringBookingInput_2024_08_13

POST

cal_com_bookings_decline_booking

/v2/bookings/{bookingUid}/decline

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
body	object	required	—

GET

cal_com_bookings_get_booking_by_seat_uid

Get a seated booking by its seat reference UID. This is useful when you have a seatUid from a seated booking and want to retrieve the full booking details. If you are fetching a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or you have to provide an authentication method of event type owner, host, team admin or owner or org admin or owner. Please make sure to pass in the cal-api-

/v2/bookings/by-seat/{seatUid}

1 parameter

Param	Type	Required	Description
seatUid	string	required	—

GET

cal_com_bookings_get_booking_recordings

Fetches all the recordings for the booking :bookingUid. Requires authentication and proper authorization. Access is granted if you are the booking organizer, team admin or org admin/owner. Recording download links are valid for 1 hour only. Make a new request to generate fresh links after expiration. cal-api-version: 2026-02-25 is required in the request header. If accessed using an OAuth access token, the BOOKING_READ scope is required.

/v2/bookings/{bookingUid}/recordings

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

GET

cal_com_bookings_get_booking_references

/v2/bookings/{bookingUid}/references

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
type	string	optional	Filter booking references by type

GET

cal_com_bookings_get_booking_transcripts

Fetches all the transcript download links for the booking :bookingUid Transcripts are generated when clicking "Transcribe" during a Cal Video meeting. Download links are valid for 1 hour only - make a new request to generate fresh links after expiration. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKING_READ scope is

/v2/bookings/{bookingUid}/transcripts

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

GET

cal_com_bookings_get_calendar_links

Retrieve calendar links for a booking that can be used to add the event to various calendar services. Returns links for Google Calendar, Microsoft Office, Microsoft Outlook, and a downloadable ICS file. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKING_READ scope is required.

/v2/bookings/{bookingUid}/calendar-links

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

GET

cal_com_bookings_get_video_sessions

Requires authentication and proper authorization. Access is granted if you are the booking organizer, team admin or org admin/owner. cal-api-version: 2026-02-25 is required in the request header. This endpoint is rate-limited to 60 requests per minute per caller (per API key, access token, OAuth client, or IP). Exceeding the limit returns a 429 response and blocks further calls for 60 seconds. If the upstream conferencing provider rate-limits the request, this endpoint responds with HTTP 429 and

/v2/bookings/{bookingUid}/conferencing-sessions

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

POST

cal_com_bookings_mark_no_show

/v2/bookings/{bookingUid}/mark-absent

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
body	object	required	—

POST

cal_com_bookings_reassign_booking

Currently only supports reassigning host for round robin bookings. The provided authorization header refers to the owner of the booking. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKING_WRITE scope is required.

/v2/bookings/{bookingUid}/reassign

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

POST

cal_com_bookings_reassign_booking_to_user

/v2/bookings/{bookingUid}/reassign/{userId}

3 parameters

Param	Type	Required	Description
bookingUid	string	required	—
userId	number	required	—
body	object	required	—

POST

cal_com_bookings_request_reschedule

Request to reschedule a booking. The booking will be cancelled and the attendee will receive an email with a link to reschedule. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKING_WRITE scope is required.

/v2/bookings/{bookingUid}/request-reschedule

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
body	object	required	—

POST

cal_com_bookings_reschedule_booking

Reschedule a booking or seated booking. Reschedulable booking statuses: - accepted — the confirmed booking is moved to the new start time. - pending — a booking awaiting host confirmation can be rescheduled. The new booking stays pending until the host confirms or declines it. Non-reschedulable booking statuses (endpoint responds with 400 Bad Request): - cancelled — the booking has already been cancelled. If it was cancelled because it was previously rescheduled, the error message includes the U

/v2/bookings/{bookingUid}/reschedule

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
body	object	required	Accepted variants: RescheduleBookingInput_2024_08_13, RescheduleSeatedBookingInput_2024_08_13

GET

cal_com_cal_unified_calendars_get_calendar_event_details

Returns detailed information about a meeting including attendance metrics. If accessed using an OAuth access token, the APPS_READ scope is required.

/v2/calendars/{calendar}/event/{eventUid}

2 parameters

Param	Type	Required	Description
calendar	string	required	—
eventUid	string	required	The Google Calendar event ID. You can retrieve this by getting booking references from the following endpoints: - For team events: https://cal.com/docs/api-reference/v2/orgs-teams-bookings/get-booking-references-for-a-booking - For user events: https://cal.com/docs/api-reference/v2/bookings/get-booking-references-for-a-booking

PATCH

cal_com_cal_unified_calendars_update_calendar_event

Updates event information in the specified calendar provider. If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/calendars/{calendar}/events/{eventUid}

3 parameters

Param	Type	Required	Description
calendar	string	required	—
eventUid	string	required	The Google Calendar event ID. You can retrieve this by getting booking references from the following endpoints: - For team events: https://cal.com/docs/api-reference/v2/orgs-teams-bookings/get-booking-references-for-a-booking - For user events: https://cal.com/docs/api-reference/v2/bookings/get-booking-references-for-a-booking
body	object	required	—

GET

cal_com_calendars_check

If accessed using an OAuth access token, the APPS_READ scope is required.

/v2/calendars/{calendar}/check

1 parameter

Param	Type	Required	Description
calendar	string	required	—

GET

cal_com_calendars_check_ics_feed

If accessed using an OAuth access token, the APPS_READ scope is required.

/v2/calendars/ics-feed/check

POST

cal_com_calendars_create_ics_feed

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/calendars/ics-feed/save

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_calendars_delete_calendar_credentials

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/calendars/{calendar}/disconnect

2 parameters

Param	Type	Required	Description
calendar	string	required	—
body	object	required	—

GET

cal_com_calendars_get_busy_times

Get busy times from a calendar. Example request URL is https://api.cal.com/v2/calendars/busy-times?timeZone=Europe%2FMadrid&dateFrom=2024-12-18&dateTo=2024-12-18&calendarsToLoad[0][credentialId]=135&calendarsToLoad[0][externalId]=skrauciz%40gmail.com. Note: loggedInUsersTz is deprecated, use timeZone instead. If accessed using an OAuth access token, the APPS_READ scope is required.

/v2/calendars/busy-times

5 parameters

Param	Type	Required	Description
loggedInUsersTz	string	optional	Deprecated: Use timeZone instead. The timezone of the user represented as a string
timeZone	string	optional	The timezone for the busy times query represented as a string
dateFrom	string	required	The starting date for the busy times query
dateTo	string	required	The ending date for the busy times query
calendarsToLoad	array	required	An array of Calendar objects representing the calendars to be loaded. Use bracket notation in the URL, e.g.: calendarsToLoad[0][credentialId]=135&calendarsToLoad[0][externalId]=email@example.com

GET

cal_com_calendars_get_calendars

If accessed using an OAuth access token, the APPS_READ scope is required.

/v2/calendars

GET

cal_com_calendars_redirect

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/calendars/{calendar}/connect

3 parameters

Param	Type	Required	Description
calendar	string	required	—
isDryRun	boolean	required	—
redir	string	optional	Redirect URL after successful calendar authorization.

POST

cal_com_calendars_sync_credentials

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/calendars/{calendar}/credentials

2 parameters

Param	Type	Required	Description
calendar	string	required	—
body	object	required	—

POST

cal_com_cancel_booking

:bookingUid can be :bookingUid of an usual booking, individual recurrence or recurring booking to cancel all recurrences. Cancelling normal bookings: If the booking is not seated and not recurring, simply pass :bookingUid in the request URL /bookings/:bookingUid/cancel and optionally cancellationReason in the request body {"cancellationReason": "Will travel"}. Cancelling seated bookings: It is possible to cancel specific seat within a booking as an attendee or all of the seats as the host. 1. As

/v2/bookings/{bookingUid}/cancel

2 parameters

Param	Type	Required	Description
bookingUid	string	required	—
body	object	required	Accepted variants: CancelBookingInput_2024_08_13, CancelSeatedBookingInput_2024_08_13

POST

cal_com_conferencing_connect

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/conferencing/{app}/connect

1 parameter

Param	Type	Required	Description
app	string	required	Conferencing application type

POST

cal_com_conferencing_default

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/conferencing/{app}/default

1 parameter

Param	Type	Required	Description
app	string	required	Conferencing application type

DELETE

cal_com_conferencing_disconnect

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/conferencing/{app}/disconnect

1 parameter

Param	Type	Required	Description
app	string	required	Conferencing application type

GET

cal_com_conferencing_get_default

If accessed using an OAuth access token, the APPS_READ scope is required.

/v2/conferencing/default

GET

cal_com_conferencing_list_installed_conferencing_apps

If accessed using an OAuth access token, the APPS_READ scope is required.

/v2/conferencing

GET

cal_com_conferencing_redirect

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/conferencing/{app}/oauth/auth-url

3 parameters

Param	Type	Required	Description
app	string	required	Conferencing application type
returnTo	string	required	—
onErrorReturnTo	string	required	—

POST

cal_com_credits_charge_credits

Charge credits for an authenticated user. Uses externalRef for idempotency to prevent double-charging. Third-party OAuth tokens require the CREDITS_WRITE scope.

/v2/credits/charge

1 parameter

Param	Type	Required	Description
body	object	required	—

GET

cal_com_credits_get_available_credits

Check if the authenticated user (or their org/team) has available credits and return the current balance. Third-party OAuth tokens require the CREDITS_READ scope.

/v2/credits/available

PUT

cal_com_destination_calendars_update_destination_calendars

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/destination-calendars

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_event_type_webhooks_create_event_type_webhook

If accessed using an OAuth access token, the EVENT_TYPE_WRITE scope is required.

/v2/event-types/{eventTypeId}/webhooks

2 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
body	object	required	—

DELETE

cal_com_event_type_webhooks_delete_all_event_type_webhooks

If accessed using an OAuth access token, the EVENT_TYPE_WRITE scope is required.

/v2/event-types/{eventTypeId}/webhooks

1 parameter

Param	Type	Required	Description
eventTypeId	number	required	—

DELETE

cal_com_event_type_webhooks_delete_event_type_webhook

If accessed using an OAuth access token, the EVENT_TYPE_WRITE scope is required.

/v2/event-types/{eventTypeId}/webhooks/{webhookId}

2 parameters

Param	Type	Required	Description
webhookId	string	required	—
eventTypeId	number	required	—

GET

cal_com_event_type_webhooks_get_event_type_webhook

If accessed using an OAuth access token, the EVENT_TYPE_READ scope is required.

/v2/event-types/{eventTypeId}/webhooks/{webhookId}

2 parameters

Param	Type	Required	Description
webhookId	string	required	—
eventTypeId	number	required	—

GET

cal_com_event_type_webhooks_get_event_type_webhooks

If accessed using an OAuth access token, the EVENT_TYPE_READ scope is required.

/v2/event-types/{eventTypeId}/webhooks

3 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

PATCH

cal_com_event_type_webhooks_update_event_type_webhook

If accessed using an OAuth access token, the EVENT_TYPE_WRITE scope is required.

/v2/event-types/{eventTypeId}/webhooks/{webhookId}

3 parameters

Param	Type	Required	Description
webhookId	string	required	—
eventTypeId	number	required	—
body	object	required	—

POST

cal_com_event_types_create_event_type

/v2/event-types

1 parameter

Param	Type	Required	Description
body	object	required	—

DELETE

cal_com_event_types_delete_event_type

/v2/event-types/{eventTypeId}

1 parameter

Param	Type	Required	Description
eventTypeId	number	required	—

GET

cal_com_event_types_get_crm_sync_errors

Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Returns CRM sync errors scoped to the requested event type and CRM app. By default this endpoint returns only active errors. Pass includeDismissed=true to include dismissed historical errors. If accessed using an OAuth access token, the EVENT_TYPE_READ scope is required.

/v2/event-types/{eventTypeId}/crm-sync-errors

5 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
appSlug	string	required	CRM app slug connected to the event type, for example salesforce.
includeDismissed	boolean	optional	When true, returns dismissed historical errors as well as active errors. Defaults to false.
cursor	string	optional	Opaque cursor from pagination.nextCursor. Omit to fetch the first page of CRM sync errors.
limit	number	optional	Maximum number of CRM sync errors to return.

GET

cal_com_event_types_get_event_type_history

Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the EVENT_TYPE_READ scope is required. Access control: This endpoint returns audit history using the same owner/admin-style audit-history access policy as the app/tRPC history query. Having general event type read access does not by itself grant access to audit history.

/v2/event-types/{eventTypeId}/history

3 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
limit	number	optional	The number of audit logs to return. Defaults to 25 and cannot exceed 50.
cursor	string	optional	Cursor from the previous response. Pass pagination.nextCursor to fetch the next page of audit logs.

GET

cal_com_event_types_get_scheduling_config

Returns the scheduling configuration for a team event type. The response shape varies by scheduling type: - roundRobin: Full configuration including hosts with priority, weight, and group assignment, host groups, and advanced settings (weights toggle, lead threshold, no-show calculations, CRM fallback). - collective: Hosts with basic info and assignAllTeamMembers. Round-robin-specific fields are omitted. - managed: Hosts with basic info and assignAllTeamMembers. Round-robin-specific fields are o

/v2/event-types/{eventTypeId}/scheduling-config

1 parameter

Param	Type	Required	Description
eventTypeId	number	required	—

POST

cal_com_event_types_private_links_create_private_link

If accessed using an OAuth access token, the EVENT_TYPE_WRITE scope is required.

/v2/event-types/{eventTypeId}/private-links

2 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
body	object	required	—

DELETE

cal_com_event_types_private_links_delete_private_link

If accessed using an OAuth access token, the EVENT_TYPE_WRITE scope is required.

/v2/event-types/{eventTypeId}/private-links/{linkId}

2 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
linkId	string	required	—

GET

cal_com_event_types_private_links_get_private_links

If accessed using an OAuth access token, the EVENT_TYPE_READ scope is required.

/v2/event-types/{eventTypeId}/private-links

1 parameter

Param	Type	Required	Description
eventTypeId	number	required	—

PATCH

cal_com_event_types_private_links_update_private_link

If accessed using an OAuth access token, the EVENT_TYPE_WRITE scope is required.

/v2/event-types/{eventTypeId}/private-links/{linkId}

3 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
linkId	string	required	—
body	object	required	—

PATCH

cal_com_event_types_update_event_type

/v2/event-types/{eventTypeId}

2 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
body	object	required	—

GET

cal_com_get_booking

:bookingUid can be 1. uid of a normal booking 2. uid of one of the recurring booking recurrences 3. uid of recurring booking which will return an array of all recurring booking recurrences (stored as recurringBookingUid on one of the individual recurrences). If you are fetching a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or you have to provide an authentication method of even

/v2/bookings/{bookingUid}

1 parameter

Param	Type	Required	Description
bookingUid	string	required	—

GET

cal_com_get_event_type

Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Access control: This endpoint fetches an event type by ID and returns it only if the authenticated user is authorized. Authorization is granted to: - System admins - The event type owner - Hosts of the event type or users assigned to the event type - Team admins/owners of the team that owns the team event type - Organiz

/v2/event-types/{eventTypeId}

1 parameter

Param	Type	Required	Description
eventTypeId	string	required	—

GET

cal_com_get_me

If accessed using an OAuth access token, the PROFILE_READ scope is required.

/v2/me

POST

cal_com_insights_get_booking_average_duration

Get average booking duration for user, team, or organization insights.

/v2/insights/bookings/average-duration

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_booking_event_trends

Get booking trend stats for user, team, or organization insights.

/v2/insights/bookings/event-trends

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_booking_kpi_stats

Get booking KPI stats for user, team, or organization insights.

/v2/insights/bookings/kpi-stats

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_booking_member_stats

Get booking member stats for user, team, or organization insights.

/v2/insights/bookings/members

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_failed_bookings_by_field

Get failed booking counts grouped by routing form field for user, team, or organization insights.

/v2/insights/routings/failed-bookings-by-field

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_routed_to_per_period

Get routed-to booking counts by user and period for user, team, or organization insights.

/v2/insights/routings/routed-to-per-period

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_routing_form_field_options

Get routing form fields and options for user, team, or organization insights.

/v2/insights/routings/form-field-options

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_routing_form_headers

Get routing form response headers for user, team, or organization insights.

/v2/insights/routings/form-response-headers

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_routing_form_responses

Get paginated routing form responses for user, team, or organization insights.

/v2/insights/routings/form-responses

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_insights_get_routing_forms_by_status

Get routing form response counts by booking status for user, team, or organization insights.

/v2/insights/routings/forms-by-status

1 parameter

Param	Type	Required	Description
body	object	required	—

GET

cal_com_list_availability

There are 4 ways to get available slots for event type of an individual user: 1. By event type id. Example '/v2/slots?eventTypeId=10&start=2050-09-05&end=2050-09-06&timeZone=Europe/Rome' 2. By event type slug + username. Example '/v2/slots?eventTypeSlug=intro&username=bob&start=2050-09-05&end=2050-09-06' 3. By event type slug + username + organization slug when searching within an organization. Example '/v2/slots?organizationSlug=org-slug&eventTypeSlug=intro&username=bob&start=2050-09-05&end=205

/v2/slots

12 parameters

Param	Type	Required	Description
bookingUidToReschedule	string	optional	The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.
start	string	required	Time starting from which available slots should be checked. Must be in UTC timezone as ISO 8601 datestring. You can pass date without hours which defaults to start of day or specify hours: 2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z.
end	string	required	Time until which available slots should be checked. Must be in UTC timezone as ISO 8601 datestring. You can pass date without hours which defaults to end of day or specify hours: 2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z.
organizationSlug	string	optional	The slug of the organization to which user with username belongs or team with teamSlug belongs.
teamSlug	string	optional	The slug of the team who owns event type with eventTypeSlug - used when slots are checked for team event type.
username	string	optional	The username of the user who owns event type with eventTypeSlug - used when slots are checked for individual user event type.
eventTypeSlug	string	optional	The slug of the event type for which available slots should be checked. If slug is provided then username or teamSlug must be provided too and if relevant organizationSlug too.
eventTypeId	number	optional	The ID of the event type for which available slots should be checked.
usernames	string	optional	The usernames for which available slots should be checked separated by a comma. Checking slots by usernames is used mainly for dynamic events where there is no specific event but we just want to know when 2 or more people are available. Must contain at least 2 usernames.
format	string	optional	Format of slot times in response. Use 'range' to get start and end times. Use 'time' or omit this query parameter to get only start time.
duration	number	optional	If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.
timeZone	string	optional	Time zone in which the available slots should be returned. Defaults to UTC.

GET

cal_com_list_bookings

Cursor-based pagination. Pass the pagination.nextCursor from the previous response as the cursor query parameter to fetch the next page. Omit cursor to fetch the first page. pagination.hasMore is false and pagination.nextCursor is null when you've reached the last page. Must pass cal-api-version: 2026-05-01 header. status filters to a single status. Pass one (e.g. ?status=upcoming) or omit to walk all statuses. To list bookings across multiple statuses, issue parallel requests — one per status —

/v2/bookings

20 parameters

Param	Type	Required	Description
status	string	optional	Filter bookings by a single status. Pass one (e.g. ?status=upcoming) or omit to walk all statuses ordered by Booking.uuid DESC. To list bookings across multiple statuses, issue parallel requests, one per status.
attendeeEmail	string	optional	Filter bookings by the attendee's email address.
attendeeName	string	optional	Filter bookings by the attendee's name.
bookingUid	string	optional	Filter bookings by the booking Uid.
eventTypeIds	string	optional	Filter bookings by event type ids. Event type ids must be separated by a comma.
eventTypeId	string	optional	Filter bookings by event type id.
teamsIds	string	optional	Filter bookings by team ids that user is part of. Team ids must be separated by a comma.
teamId	string	optional	Filter bookings by team id that user is part of
afterStart	string	optional	Filter bookings with start after this date string.
beforeEnd	string	optional	Filter bookings with end before this date string.
afterCreatedAt	string	optional	Filter bookings that have been created after this date string.
beforeCreatedAt	string	optional	Filter bookings that have been created before this date string.
afterUpdatedAt	string	optional	Filter bookings that have been updated after this date string.
beforeUpdatedAt	string	optional	Filter bookings that have been updated before this date string.
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.
sortCreated	string	optional	Sort results by their creation time (when booking was made) in ascending or descending order.
sortUpdatedAt	string	optional	Sort results by their updated time (for example when booking status changes) in ascending or descending order.
cursor	string	optional	Opaque cursor for cursor-based pagination. Pass the pagination.nextCursor value from a previous response to fetch the next page. Omit to fetch the first page.
limit	number	optional	The number of items to return

GET

cal_com_list_event_types

Hidden event types are returned only if authentication is provided and it belongs to the event type owner. Use the optional sortCreatedAt query parameter to order results by creation date (by ID). Accepts "asc" (oldest first) or "desc" (newest first). When not provided, no explicit ordering is applied. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.

/v2/event-types

6 parameters

Param	Type	Required	Description
username	string	optional	The username of the user to get event types for. If only username provided will get all event types.
eventSlug	string	optional	Slug of event type to return. Notably, if eventSlug is provided then username must be provided too, because multiple users can have event with same slug.
usernames	string	optional	Get dynamic event type for multiple usernames separated by comma. e.g usernames=alice,bob
orgSlug	string	optional	slug of the user's organization if he is in one, orgId is not required if using this parameter
orgId	number	optional	ID of the organization of the user you want the get the event-types of, orgSlug is not needed when using this parameter
sortCreatedAt	string	optional	Sort event types by creation date. When not provided, no explicit ordering is applied.

GET

cal_com_list_schedules

Get all schedules of the authenticated user. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the SCHEDULE_READ scope is required.

/v2/schedules

DELETE

cal_com_me_clear_my_booking_limits

Removes all of the authenticated user's global booking limits. Only available to organization members — non-org accounts receive a 403. If accessed using an OAuth access token, the PROFILE_WRITE scope is required.

/v2/me/booking-limits

GET

cal_com_me_get_my_booking_limits

Returns the authenticated user's global booking limits. Unset bounds are returned as null. Only available to organization members — non-org accounts receive a 403. If accessed using an OAuth access token, the PROFILE_READ scope is required.

/v2/me/booking-limits

PATCH

cal_com_me_update_me

Updates the authenticated user's profile. Email changes require verification and the primary email stays unchanged until verification completes, unless the new email is already a verified secondary email or the user is platform-managed. If accessed using an OAuth access token, the PROFILE_WRITE scope is required.

/v2/me

1 parameter

Param	Type	Required	Description
body	object	required	—

PATCH

cal_com_me_update_my_booking_limits

Partially updates the authenticated user's global booking limits. Only fields present in the request body are changed; omit a field to leave it untouched, or set it to null to remove that limit. Only available to organization members — non-org accounts receive a 403. If accessed using an OAuth access token, the PROFILE_WRITE scope is required.

/v2/me/booking-limits

1 parameter

Param	Type	Required	Description
body	object	required	—

GET

cal_com_org_teams_verified_resources_get_verified_email_by_id

Required membership role: team admin. PBAC permission: team.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_READ scope is required.

/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/{id}

3 parameters

Param	Type	Required	Description
id	number	required	—
teamId	number	required	—
orgId	number	required	—

GET

cal_com_org_teams_verified_resources_get_verified_emails

/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails

4 parameters

Param	Type	Required	Description
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
orgId	number	required	—

GET

cal_com_org_teams_verified_resources_get_verified_phone_by_id

/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/{id}

3 parameters

Param	Type	Required	Description
teamId	number	required	—
id	number	required	—
orgId	number	required	—

GET

cal_com_org_teams_verified_resources_get_verified_phone_numbers

/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones

4 parameters

Param	Type	Required	Description
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
orgId	number	required	—

POST

cal_com_org_teams_verified_resources_request_email_verification_code

Sends a verification code to the email. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/verification-code/request

3 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_org_teams_verified_resources_request_phone_verification_code

Sends a verification code to the phone number. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/verification-code/request

3 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_org_teams_verified_resources_verify_email

Use code to verify an email. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/verification-code/verify

3 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_org_teams_verified_resources_verify_phone_number

Use code to verify a phone number. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/verification-code/verify

3 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_organization_team_workflows_create_event_type_workflow

Required membership role: team admin. PBAC permission: workflow.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_WORKFLOW_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/workflows

3 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_organization_team_workflows_create_form_workflow

/v2/organizations/{orgId}/teams/{teamId}/workflows/routing-form

3 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
body	object	required	—

DELETE

cal_com_organization_team_workflows_delete_routing_form_workflow

Required membership role: team admin. PBAC permission: workflow.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_WORKFLOW_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form

3 parameters

Param	Type	Required	Description
teamId	number	required	—
workflowId	number	required	—
orgId	number	required	—

DELETE

cal_com_organization_team_workflows_delete_workflow

/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}

3 parameters

Param	Type	Required	Description
teamId	number	required	—
workflowId	number	required	—
orgId	number	required	—

GET

cal_com_organization_team_workflows_get_routing_form_workflow_by_id

Required membership role: team admin. PBAC permission: workflow.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_WORKFLOW_READ scope is required.

/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form

3 parameters

Param	Type	Required	Description
teamId	number	required	—
workflowId	number	required	—
orgId	number	required	—

GET

cal_com_organization_team_workflows_get_routing_form_workflows

/v2/organizations/{orgId}/teams/{teamId}/workflows/routing-form

4 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_organization_team_workflows_get_workflow_by_id

/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}

3 parameters

Param	Type	Required	Description
teamId	number	required	—
workflowId	number	required	—
orgId	number	required	—

GET

cal_com_organization_team_workflows_get_workflows

/v2/organizations/{orgId}/teams/{teamId}/workflows

4 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

PATCH

cal_com_organization_team_workflows_update_routing_form_workflow

Required membership role: team admin. PBAC permission: workflow.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_WORKFLOW_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form

4 parameters

Param	Type	Required	Description
teamId	number	required	—
workflowId	number	required	—
orgId	number	required	—
body	object	required	—

PATCH

cal_com_organization_team_workflows_update_workflow

/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}

4 parameters

Param	Type	Required	Description
teamId	number	required	—
workflowId	number	required	—
orgId	number	required	—
body	object	required	—

GET

cal_com_organizations_attributes_get_organization_attribute

Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control

/v2/organizations/{orgId}/attributes/{attributeId}

2 parameters

Param	Type	Required	Description
orgId	number	required	—
attributeId	string	required	—

GET

cal_com_organizations_attributes_get_organization_attributes

Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control

/v2/organizations/{orgId}/attributes

3 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

POST

cal_com_organizations_attributes_options_assign_organization_attribute_option_to_user

Required membership role: org admin. PBAC permission: organization.attributes.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control

/v2/organizations/{orgId}/attributes/options/{userId}

3 parameters

Param	Type	Required	Description
orgId	number	required	—
userId	number	required	—
body	object	required	—

GET

cal_com_organizations_attributes_options_get_organization_attribute_options

Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control

/v2/organizations/{orgId}/attributes/{attributeId}/options

2 parameters

Param	Type	Required	Description
orgId	number	required	—
attributeId	string	required	—

DELETE

cal_com_organizations_attributes_options_unassign_organization_attribute_option_from_user

Required membership role: org admin. PBAC permission: organization.attributes.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control

/v2/organizations/{orgId}/attributes/options/{userId}/{attributeOptionId}

3 parameters

Param	Type	Required	Description
orgId	number	required	—
userId	number	required	—
attributeOptionId	string	required	—

PATCH

cal_com_organizations_attributes_options_update_organization_attribute_option_for_user

Required membership role: org admin. PBAC permission: organization.attributes.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control

/v2/organizations/{orgId}/attributes/options/{userId}/{attributeOptionId}

4 parameters

Param	Type	Required	Description
orgId	number	required	—
userId	number	required	—
attributeOptionId	string	required	—
body	object	required	—

GET

cal_com_organizations_bookings_get_all_org_team_bookings_cursor

Cursor-paginated org bookings listing. Pass the pagination.nextCursor from the previous response as the cursor query parameter to fetch the next page. Omit cursor to fetch the first page. pagination.hasMore is false and pagination.nextCursor is null when you've reached the last page. Must pass cal-api-version: 2026-05-01 header. status filters to a single status. Pass one (e.g. ?status=upcoming) or omit to walk all statuses. To list bookings across multiple statuses, issue parallel requests — on

/v2/organizations/{orgId}/bookings

22 parameters

Param	Type	Required	Description
status	string	optional	Filter bookings by a single status. Pass one (e.g. ?status=upcoming) or omit to walk all statuses ordered by Booking.uuid DESC. To list bookings across multiple statuses, issue parallel requests, one per status.
attendeeEmail	string	optional	Filter bookings by the attendee's email address.
attendeeName	string	optional	Filter bookings by the attendee's name.
bookingUid	string	optional	Filter bookings by the booking Uid.
eventTypeIds	string	optional	Filter bookings by event type ids. Event type ids must be separated by a comma.
eventTypeId	string	optional	Filter bookings by event type id.
teamsIds	string	optional	Filter bookings by team ids that user is part of. Team ids must be separated by a comma.
teamId	string	optional	Filter bookings by team id that user is part of
afterStart	string	optional	Filter bookings with start after this date string.
beforeEnd	string	optional	Filter bookings with end before this date string.
afterCreatedAt	string	optional	Filter bookings that have been created after this date string.
beforeCreatedAt	string	optional	Filter bookings that have been created before this date string.
afterUpdatedAt	string	optional	Filter bookings that have been updated after this date string.
beforeUpdatedAt	string	optional	Filter bookings that have been updated before this date string.
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.
sortCreated	string	optional	Sort results by their creation time (when booking was made) in ascending or descending order.
sortUpdatedAt	string	optional	Sort results by their updated time (for example when booking status changes) in ascending or descending order.
cursor	string	optional	Opaque cursor for cursor-based pagination. Pass the pagination.nextCursor value from a previous response to fetch the next page. Omit to fetch the first page.
limit	number	optional	The number of items to return
userIds	string	optional	Filter bookings by ids of users within your organization.
orgId	number	required	—

POST

cal_com_organizations_conferencing_connect_team_app

Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_APPS_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/connect

3 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
app	string	required	Conferencing application type

DELETE

cal_com_organizations_conferencing_disconnect_team_app

/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/disconnect

3 parameters

Param	Type	Required	Description
teamId	number	required	—
app	string	required	Conferencing application type
orgId	number	required	—

GET

cal_com_organizations_conferencing_get_team_default_app

/v2/organizations/{orgId}/teams/{teamId}/conferencing/default

2 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—

GET

cal_com_organizations_conferencing_get_team_oauth_url

/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/auth-url

5 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
app	string	required	Conferencing application type
returnTo	string	required	—
onErrorReturnTo	string	required	—

GET

cal_com_organizations_conferencing_list_team_conferencing_apps

/v2/organizations/{orgId}/teams/{teamId}/conferencing

2 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—

GET

cal_com_organizations_conferencing_save_team_oauth_credentials

/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/callback

5 parameters

Param	Type	Required	Description
state	string	required	—
code	string	required	—
teamId	number	required	—
orgId	number	required	—
app	string	required	—

POST

cal_com_organizations_conferencing_set_team_default_app

/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/default

3 parameters

Param	Type	Required	Description
teamId	number	required	—
app	string	required	Conferencing application type
orgId	number	required	—

POST

cal_com_organizations_event_types_create_phone_call

Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/create-phone-call

4 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_organizations_event_types_create_team_event_type

Required membership role: team admin. PBAC permission: eventType.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/event-types

3 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—
body	object	required	—

DELETE

cal_com_organizations_event_types_delete_team_event_type

Required membership role: team admin. PBAC permission: eventType.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}

3 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
orgId	number	required	—

GET

cal_com_organizations_event_types_get_team_event_type

Required membership role: team admin. PBAC permission: eventType.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_EVENT_TYPE_READ scope is required.

/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}

3 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
orgId	number	required	—

GET

cal_com_organizations_event_types_get_team_event_types

Use the optional sortCreatedAt query parameter to order results by creation date (by ID). Accepts "asc" (oldest first) or "desc" (newest first). When not provided, no explicit ordering is applied.

/v2/organizations/{orgId}/teams/{teamId}/event-types

5 parameters

Param	Type	Required	Description
teamId	number	required	—
eventSlug	string	optional	Slug of team event type to return.
hostsLimit	number	optional	Specifies the maximum number of hosts to include in the response. This limit helps optimize performance. If not provided, all Hosts will be fetched.
sortCreatedAt	string	optional	Sort event types by creation date. When not provided, no explicit ordering is applied.
orgId	number	required	—

GET

cal_com_organizations_event_types_get_teams_event_types

Use the optional sortCreatedAt query parameter to order results by creation date (by ID). Accepts "asc" (oldest first) or "desc" (newest first). When not provided, no explicit ordering is applied. Required membership role: team admin. PBAC permission: eventType.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_EVENT_TYPE_READ scope is required.

/v2/organizations/{orgId}/teams/event-types

4 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
sortCreatedAt	string	optional	Sort event types by creation date. When not provided, no explicit ordering is applied.

POST

cal_com_organizations_event_types_private_links_create_private_link

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links

4 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
orgId	number	required	—
body	object	required	—

DELETE

cal_com_organizations_event_types_private_links_delete_private_link

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links/{linkId}

4 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
linkId	string	required	—
orgId	number	required	—

GET

cal_com_organizations_event_types_private_links_get_private_links

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_READ scope is required.

/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links

3 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
orgId	number	required	—

PATCH

cal_com_organizations_event_types_private_links_update_private_link

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links/{linkId}

4 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
linkId	string	required	—
orgId	number	required	—

PATCH

cal_com_organizations_event_types_update_team_event_type

/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}

4 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_organizations_memberships_create_membership

Required membership role: org admin. PBAC permission: organization.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_MEMBERSHIP_WRITE scope is required. Two identifier modes are accepted in the request body: 1. userId — attach an existing user (by id) directly. Use when the caller already knows the Cal.com user id and just needs the membership row created/updated. No notification email is sent. 2.

/v2/organizations/{orgId}/memberships

2 parameters

Param	Type	Required	Description
orgId	number	required	—
body	object	required	Accepted variants: CreateOrgMembershipDto, CreateOrgMembershipByEmailDto

DELETE

cal_com_organizations_memberships_delete_membership

Required membership role: org admin. PBAC permission: organization.remove. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_MEMBERSHIP_WRITE scope is required.

/v2/organizations/{orgId}/memberships/{membershipId}

2 parameters

Param	Type	Required	Description
orgId	number	required	—
membershipId	number	required	—

GET

cal_com_organizations_memberships_get_all_memberships

Required membership role: org admin. PBAC permission: organization.listMembers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_MEMBERSHIP_READ scope is required.

/v2/organizations/{orgId}/memberships

3 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_organizations_memberships_get_org_membership

/v2/organizations/{orgId}/memberships/{membershipId}

2 parameters

Param	Type	Required	Description
orgId	number	required	—
membershipId	number	required	—

PATCH

cal_com_organizations_memberships_update_membership

Required membership role: org admin. PBAC permission: organization.changeMemberRole. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_MEMBERSHIP_WRITE scope is required.

/v2/organizations/{orgId}/memberships/{membershipId}

3 parameters

Param	Type	Required	Description
orgId	number	required	—
membershipId	number	required	—
body	object	required	—

GET

cal_com_organizations_routing_forms_get_organization_routing_forms

Required membership role: org admin. PBAC permission: routingForm.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_ROUTING_FORM_READ scope is required.

/v2/organizations/{orgId}/routing-forms

11 parameters

Param	Type	Required	Description
orgId	number	required	—
skip	number	optional	Number of responses to skip
take	number	optional	Number of responses to take
sortCreatedAt	string	optional	Sort by creation time
sortUpdatedAt	string	optional	Sort by update time
afterCreatedAt	string	optional	Filter by responses created after this date
beforeCreatedAt	string	optional	Filter by responses created before this date
afterUpdatedAt	string	optional	Filter by responses created after this date
beforeUpdatedAt	string	optional	Filter by responses updated before this date
routedToBookingUid	string	optional	Filter by responses routed to a specific booking
teamIds	array	optional	Filter by teamIds. Team ids must be separated by a comma.

POST

cal_com_organizations_routing_forms_responses_create_routing_form_response

Required membership role: org admin. PBAC permission: routingForm.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_ROUTING_FORM_WRITE scope is required.

/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses

10 parameters

Param	Type	Required	Description
orgId	number	required	—
routingFormId	string	required	—
start	string	required	Time starting from which available slots should be checked. Must be in UTC timezone as ISO 8601 datestring. You can pass date without hours which defaults to start of day or specify hours: 2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z
end	string	required	Time until which available slots should be checked. Must be in UTC timezone as ISO 8601 datestring. You can pass date without hours which defaults to end of day or specify hours: 2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z
timeZone	string	optional	Time zone in which the available slots should be returned. Defaults to UTC.
duration	number	optional	If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.
format	string	optional	Format of slot times in response. Use 'range' to get start and end times.
bookingUidToReschedule	string	optional	The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.
rescheduleWithSameHost	boolean	optional	Only for round robin event types that allow the person rescheduling to choose the host. True returns slots of the original host, false returns slots of any available host. Ignored for other event types.
queueResponse	boolean	optional	Whether to queue the form response.

GET

cal_com_organizations_routing_forms_responses_get_routing_form_responses

/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses

11 parameters

Param	Type	Required	Description
orgId	number	required	—
routingFormId	string	required	—
skip	number	optional	Number of responses to skip
take	number	optional	Number of responses to take
sortCreatedAt	string	optional	Sort by creation time
sortUpdatedAt	string	optional	Sort by update time
afterCreatedAt	string	optional	Filter by responses created after this date
beforeCreatedAt	string	optional	Filter by responses created before this date
afterUpdatedAt	string	optional	Filter by responses created after this date
beforeUpdatedAt	string	optional	Filter by responses updated before this date
routedToBookingUid	string	optional	Filter by responses routed to a specific booking

PATCH

cal_com_organizations_routing_forms_responses_update_routing_form_response

Required membership role: org admin. PBAC permission: routingForm.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_ROUTING_FORM_WRITE scope is required.

/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses/{responseId}

4 parameters

Param	Type	Required	Description
orgId	number	required	—
routingFormId	string	required	—
responseId	number	required	—
body	object	required	—

POST

cal_com_organizations_schedules_create_user_schedule

Required membership role: org admin. PBAC permission: availability.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_SCHEDULE_WRITE scope is required.

/v2/organizations/{orgId}/users/{userId}/schedules

3 parameters

Param	Type	Required	Description
userId	number	required	—
orgId	number	required	—
body	object	required	—

DELETE

cal_com_organizations_schedules_delete_user_schedule

Required membership role: org admin. PBAC permission: availability.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_SCHEDULE_WRITE scope is required.

/v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId}

3 parameters

Param	Type	Required	Description
userId	number	required	—
scheduleId	number	required	—
orgId	number	required	—

GET

cal_com_organizations_schedules_get_organization_schedules

Required membership role: org admin. PBAC permission: availability.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_SCHEDULE_READ scope is required.

/v2/organizations/{orgId}/schedules

3 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_organizations_schedules_get_user_schedule

/v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId}

3 parameters

Param	Type	Required	Description
userId	number	required	—
scheduleId	number	required	—
orgId	number	required	—

GET

cal_com_organizations_schedules_get_user_schedules

/v2/organizations/{orgId}/users/{userId}/schedules

2 parameters

Param	Type	Required	Description
userId	number	required	—
orgId	number	required	—

PATCH

cal_com_organizations_schedules_update_user_schedule

Required membership role: org admin. PBAC permission: availability.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_SCHEDULE_WRITE scope is required.

/v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId}

4 parameters

Param	Type	Required	Description
userId	number	required	—
scheduleId	number	required	—
orgId	number	required	—
body	object	required	—

GET

cal_com_organizations_teams_bookings_get_all_org_team_bookings

Required membership role: team admin. PBAC permission: booking.readTeamBookings. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_BOOKING_READ scope is required.

/v2/organizations/{orgId}/teams/{teamId}/bookings

20 parameters

Param	Type	Required	Description
status	array	optional	Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.
attendeeEmail	string	optional	Filter bookings by the attendee's email address.
attendeeName	string	optional	Filter bookings by the attendee's name.
bookingUid	string	optional	Filter bookings by the booking Uid.
eventTypeIds	string	optional	Filter bookings by event type ids. Event type ids must be separated by a comma.
eventTypeId	string	optional	Filter bookings by event type id.
afterStart	string	optional	Filter bookings with start after this date string.
beforeEnd	string	optional	Filter bookings with end before this date string.
afterCreatedAt	string	optional	Filter bookings that have been created after this date string.
beforeCreatedAt	string	optional	Filter bookings that have been created before this date string.
afterUpdatedAt	string	optional	Filter bookings that have been updated after this date string.
beforeUpdatedAt	string	optional	Filter bookings that have been updated before this date string.
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.
sortCreated	string	optional	Sort results by their creation time (when booking was made) in ascending or descending order.
sortUpdatedAt	string	optional	Sort results by their updated time (for example when booking status changes) in ascending or descending order.
take	number	optional	The number of items to return
skip	number	optional	The number of items to skip
teamId	number	required	—
orgId	number	required	—

GET

cal_com_organizations_teams_bookings_get_booking_references

/v2/organizations/{orgId}/teams/{teamId}/bookings/{bookingUid}/references

4 parameters

Param	Type	Required	Description
bookingUid	string	required	—
type	string	optional	Filter booking references by type
teamId	number	required	—
orgId	number	required	—

POST

cal_com_organizations_teams_create_team

Required membership role: org admin. PBAC permission: team.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_PROFILE_WRITE scope is required.

/v2/organizations/{orgId}/teams

2 parameters

Param	Type	Required	Description
orgId	number	required	—
body	object	required	—

DELETE

cal_com_organizations_teams_delete_team

Required membership role: org admin. PBAC permission: team.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_PROFILE_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}

2 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—

GET

cal_com_organizations_teams_get_all_teams

Required membership role: org admin. PBAC permission: team.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_PROFILE_READ scope is required.

/v2/organizations/{orgId}/teams

3 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_organizations_teams_get_my_teams

Required membership role: org member. PBAC permission: team.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_MEMBERSHIP_READ scope is required.

/v2/organizations/{orgId}/teams/me

3 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_organizations_teams_get_team

/v2/organizations/{orgId}/teams/{teamId}

2 parameters

Param	Type	Required	Description
teamId	number	required	—
orgId	number	required	—

POST

cal_com_organizations_teams_invite_create_invite

Required membership role: team admin. PBAC permission: team.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_MEMBERSHIP_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/invite

2 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—

POST

cal_com_organizations_teams_memberships_create_org_team_membership

/v2/organizations/{orgId}/teams/{teamId}/memberships

3 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
body	object	required	—

DELETE

cal_com_organizations_teams_memberships_delete_org_team_membership

Required membership role: team admin. PBAC permission: team.remove. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_MEMBERSHIP_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId}

3 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
membershipId	number	required	—

GET

cal_com_organizations_teams_memberships_get_all_org_team_memberships

Required membership role: team admin. PBAC permission: team.listMembers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_MEMBERSHIP_READ scope is required.

/v2/organizations/{orgId}/teams/{teamId}/memberships

4 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_organizations_teams_memberships_get_org_team_membership

/v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId}

3 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
membershipId	number	required	—

PATCH

cal_com_organizations_teams_memberships_update_org_team_membership

Required membership role: team admin. PBAC permission: team.changeMemberRole. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_MEMBERSHIP_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId}

4 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
membershipId	number	required	—
body	object	required	—

GET

cal_com_organizations_teams_routing_forms_get_team_routing_forms

Required membership role: team admin. PBAC permission: routingForm.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_ROUTING_FORM_READ scope is required.

/v2/organizations/{orgId}/teams/{teamId}/routing-forms

11 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
skip	number	optional	Number of responses to skip
take	number	optional	Number of responses to take
sortCreatedAt	string	optional	Sort by creation time
sortUpdatedAt	string	optional	Sort by update time
afterCreatedAt	string	optional	Filter by responses created after this date
beforeCreatedAt	string	optional	Filter by responses created before this date
afterUpdatedAt	string	optional	Filter by responses created after this date
beforeUpdatedAt	string	optional	Filter by responses updated before this date
routedToBookingUid	string	optional	Filter by responses routed to a specific booking

POST

cal_com_organizations_teams_routing_forms_responses_create_routing_form_response

Required membership role: team member. PBAC permission: routingForm.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_ROUTING_FORM_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses

11 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
routingFormId	string	required	—
start	string	required	Time starting from which available slots should be checked. Must be in UTC timezone as ISO 8601 datestring. You can pass date without hours which defaults to start of day or specify hours: 2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z
end	string	required	Time until which available slots should be checked. Must be in UTC timezone as ISO 8601 datestring. You can pass date without hours which defaults to end of day or specify hours: 2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z
timeZone	string	optional	Time zone in which the available slots should be returned. Defaults to UTC.
duration	number	optional	If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.
format	string	optional	Format of slot times in response. Use 'range' to get start and end times.
bookingUidToReschedule	string	optional	The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.
rescheduleWithSameHost	boolean	optional	Only for round robin event types that allow the person rescheduling to choose the host. True returns slots of the original host, false returns slots of any available host. Ignored for other event types.
queueResponse	boolean	optional	Whether to queue the form response.

GET

cal_com_organizations_teams_routing_forms_responses_get_routing_form_responses

/v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses

12 parameters

Param	Type	Required	Description
routingFormId	string	required	—
orgId	number	required	—
teamId	number	required	—
skip	number	optional	Number of responses to skip
take	number	optional	Number of responses to take
sortCreatedAt	string	optional	Sort by creation time
sortUpdatedAt	string	optional	Sort by update time
afterCreatedAt	string	optional	Filter by responses created after this date
beforeCreatedAt	string	optional	Filter by responses created before this date
afterUpdatedAt	string	optional	Filter by responses created after this date
beforeUpdatedAt	string	optional	Filter by responses updated before this date
routedToBookingUid	string	optional	Filter by responses routed to a specific booking

PATCH

cal_com_organizations_teams_routing_forms_responses_update_routing_form_response

Required membership role: team admin. PBAC permission: routingForm.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_ROUTING_FORM_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses/{responseId}

5 parameters

Param	Type	Required	Description
teamId	number	required	—
routingFormId	string	required	—
responseId	number	required	—
orgId	number	required	—
body	object	required	—

GET

cal_com_organizations_teams_schedules_get_team_schedules

Required membership role: team admin. PBAC permission: availability.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_SCHEDULE_READ scope is required.

/v2/organizations/{orgId}/teams/{teamId}/schedules

5 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
eventTypeId	number	optional	Filter schedules by event type ID

GET

cal_com_organizations_teams_schedules_get_user_schedules

/v2/organizations/{orgId}/teams/{teamId}/users/{userId}/schedules

4 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
userId	number	required	—
eventTypeId	number	optional	Filter schedules by event type ID

PATCH

cal_com_organizations_teams_update_team

Required membership role: org admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_PROFILE_WRITE scope is required.

/v2/organizations/{orgId}/teams/{teamId}

3 parameters

Param	Type	Required	Description
orgId	number	required	—
teamId	number	required	—
body	object	required	—

GET

cal_com_organizations_users_bookings_get_organization_user_bookings

If accessed using an OAuth access token, the ORG_BOOKING_READ scope is required.

/v2/organizations/{orgId}/users/{userId}/bookings

22 parameters

Param	Type	Required	Description
orgId	number	required	—
userId	number	required	—
status	array	optional	Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.
attendeeEmail	string	optional	Filter bookings by the attendee's email address.
attendeeName	string	optional	Filter bookings by the attendee's name.
bookingUid	string	optional	Filter bookings by the booking Uid.
eventTypeIds	string	optional	Filter bookings by event type ids. Event type ids must be separated by a comma.
eventTypeId	string	optional	Filter bookings by event type id.
teamsIds	string	optional	Filter bookings by team ids that user is part of. Team ids must be separated by a comma.
teamId	string	optional	Filter bookings by team id that user is part of
afterStart	string	optional	Filter bookings with start after this date string.
beforeEnd	string	optional	Filter bookings with end before this date string.
afterCreatedAt	string	optional	Filter bookings that have been created after this date string.
beforeCreatedAt	string	optional	Filter bookings that have been created before this date string.
afterUpdatedAt	string	optional	Filter bookings that have been updated after this date string.
beforeUpdatedAt	string	optional	Filter bookings that have been updated before this date string.
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.
sortCreated	string	optional	Sort results by their creation time (when booking was made) in ascending or descending order.
sortUpdatedAt	string	optional	Sort results by their updated time (for example when booking status changes) in ascending or descending order.
take	number	optional	The number of items to return
skip	number	optional	The number of items to skip

GET

cal_com_organizations_users_conferencing_list_conferencing_apps

Lists all connected conferencing apps for a specific user within the organization, including which one is set as default. If accessed using an OAuth access token, the APPS_READ scope is required.

/v2/organizations/{orgId}/users/{userId}/conferencing

2 parameters

Param	Type	Required	Description
userId	number	required	—
orgId	number	required	—

POST

cal_com_organizations_users_conferencing_set_default_conferencing_app

Sets the default conferencing app for a specific user within the organization. If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/organizations/{orgId}/users/{userId}/conferencing/default

3 parameters

Param	Type	Required	Description
userId	number	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_organizations_users_create_organization_user

Required membership role: org admin. PBAC permission: organization.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_MEMBERSHIP_WRITE scope is required. This endpoint creates a brand-new Cal.com user account and attaches them to the organization. If the email already belongs to an existing Cal.com user, the request fails with 409 Conflict. When the user is already a member of this organization the

/v2/organizations/{orgId}/users

2 parameters

Param	Type	Required	Description
orgId	number	required	—
body	object	required	—

DELETE

cal_com_organizations_users_delete_organization_user

/v2/organizations/{orgId}/users/{userId}

2 parameters

Param	Type	Required	Description
orgId	number	required	—
userId	number	required	—

GET

cal_com_organizations_users_get_organizations_users

/v2/organizations/{orgId}/users

7 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	The number of items to return
skip	number	optional	The number of items to skip
emails	array	optional	The email address or an array of email addresses to filter by
assignedOptionIds	array	optional	Filter by assigned attribute option ids. ids must be separated by a comma.
attributeQueryOperator	string	optional	Query operator used to filter assigned options, AND by default.
teamIds	array	optional	Filter by teamIds. Team ids must be separated by a comma.

POST

cal_com_organizations_users_ooo_create_organization_user_ooo

If accessed using an OAuth access token, the ORG_SCHEDULE_WRITE scope is required.

/v2/organizations/{orgId}/users/{userId}/ooo

3 parameters

Param	Type	Required	Description
userId	number	required	—
orgId	number	required	—
body	object	required	—

DELETE

cal_com_organizations_users_ooo_delete_organization_user_ooo

If accessed using an OAuth access token, the ORG_SCHEDULE_WRITE scope is required.

/v2/organizations/{orgId}/users/{userId}/ooo/{oooId}

3 parameters

Param	Type	Required	Description
oooId	number	required	—
userId	number	required	—
orgId	number	required	—

GET

cal_com_organizations_users_ooo_get_organization_user_ooo

If accessed using an OAuth access token, the ORG_SCHEDULE_READ scope is required.

/v2/organizations/{orgId}/users/{userId}/ooo

6 parameters

Param	Type	Required	Description
userId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.
orgId	number	required	—

GET

cal_com_organizations_users_ooo_get_organization_users_ooo

If accessed using an OAuth access token, the ORG_SCHEDULE_READ scope is required.

/v2/organizations/{orgId}/ooo

6 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.
email	string	optional	Filter ooo entries by the user email address. user must be within your organization.

PATCH

cal_com_organizations_users_ooo_update_organization_user_ooo

If accessed using an OAuth access token, the ORG_SCHEDULE_WRITE scope is required.

/v2/organizations/{orgId}/users/{userId}/ooo/{oooId}

4 parameters

Param	Type	Required	Description
userId	number	required	—
oooId	number	required	—
orgId	number	required	—
body	object	required	—

PATCH

cal_com_organizations_users_update_organization_user

Required membership role: org admin. PBAC permission: organization.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_MEMBERSHIP_WRITE scope is required.

/v2/organizations/{orgId}/users/{userId}

3 parameters

Param	Type	Required	Description
orgId	number	required	—
userId	number	required	—
body	object	required	—

POST

cal_com_organizations_webhooks_create_organization_webhook

Required membership role: org admin. PBAC permission: webhook.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_WEBHOOK_WRITE scope is required.

/v2/organizations/{orgId}/webhooks

2 parameters

Param	Type	Required	Description
orgId	number	required	—
body	object	required	—

DELETE

cal_com_organizations_webhooks_delete_webhook

Required membership role: org admin. PBAC permission: webhook.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_WEBHOOK_WRITE scope is required.

/v2/organizations/{orgId}/webhooks/{webhookId}

2 parameters

Param	Type	Required	Description
webhookId	string	required	—
orgId	number	required	—

GET

cal_com_organizations_webhooks_get_all_organization_webhooks

Required membership role: org admin. PBAC permission: webhook.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_WEBHOOK_READ scope is required.

/v2/organizations/{orgId}/webhooks

3 parameters

Param	Type	Required	Description
orgId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_organizations_webhooks_get_organization_webhook

/v2/organizations/{orgId}/webhooks/{webhookId}

2 parameters

Param	Type	Required	Description
webhookId	string	required	—
orgId	number	required	—

PATCH

cal_com_organizations_webhooks_update_org_webhook

Required membership role: org admin. PBAC permission: webhook.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORG_WEBHOOK_WRITE scope is required.

/v2/organizations/{orgId}/webhooks/{webhookId}

3 parameters

Param	Type	Required	Description
webhookId	string	required	—
orgId	number	required	—
body	object	required	—

POST

cal_com_schedules_create_schedule

Create a schedule for the authenticated user. The point of creating schedules is for event types to be available at specific times. The first goal of schedules is to have a default schedule. If you are platform customer and created managed users, then it is important to note that each managed user should have a default schedule. 1. If you passed timeZone when creating managed user, then the default schedule from Monday to Friday from 9AM to 5PM will be created with that timezone. The managed use

/v2/schedules

1 parameter

Param	Type	Required	Description
body	object	required	—

DELETE

cal_com_schedules_delete_schedule

/v2/schedules/{scheduleId}

1 parameter

Param	Type	Required	Description
scheduleId	number	required	—

GET

cal_com_schedules_get_default_schedule

Get the default schedule of the authenticated user. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the SCHEDULE_READ scope is required.

/v2/schedules/default

GET

cal_com_schedules_get_schedule

/v2/schedules/{scheduleId}

1 parameter

Param	Type	Required	Description
scheduleId	number	required	—

PATCH

cal_com_schedules_update_schedule

/v2/schedules/{scheduleId}

2 parameters

Param	Type	Required	Description
scheduleId	string	required	—
body	object	required	—

POST

cal_com_selected_calendars_add_selected_calendar

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/selected-calendars

1 parameter

Param	Type	Required	Description
body	object	required	—

DELETE

cal_com_selected_calendars_delete_selected_calendar

If accessed using an OAuth access token, the APPS_WRITE scope is required.

/v2/selected-calendars

4 parameters

Param	Type	Required	Description
integration	string	required	—
externalId	string	required	—
credentialId	string	required	—
delegationCredentialId	string	optional	—

DELETE

cal_com_slots_delete_reserved_slot

Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.

/v2/slots/reservations/{uid}

1 parameter

Param	Type	Required	Description
uid	string	required	—

GET

cal_com_slots_get_reserved_slot

Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.

/v2/slots/reservations/{uid}

1 parameter

Param	Type	Required	Description
uid	string	required	—

POST

cal_com_slots_reserve_slot

Make a slot not available for others to book for a certain period of time. If you authenticate using oAuth credentials, api key or access token then you can also specify custom duration for how long the slot should be reserved for (defaults to 5 minutes). Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.

/v2/slots/reservations

1 parameter

Param	Type	Required	Description
body	object	required	—

PATCH

cal_com_slots_update_reserved_slot

Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.

/v2/slots/reservations/{uid}

2 parameters

Param	Type	Required	Description
uid	string	required	—
body	object	required	—

GET

cal_com_teams_bookings_get_all_team_bookings

If accessed using an OAuth access token, the TEAM_BOOKING_READ scope is required.

/v2/teams/{teamId}/bookings

19 parameters

Param	Type	Required	Description
status	array	optional	Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.
attendeeEmail	string	optional	Filter bookings by the attendee's email address.
attendeeName	string	optional	Filter bookings by the attendee's name.
bookingUid	string	optional	Filter bookings by the booking Uid.
eventTypeIds	string	optional	Filter bookings by event type ids. Event type ids must be separated by a comma.
eventTypeId	string	optional	Filter bookings by event type id.
afterStart	string	optional	Filter bookings with start after this date string.
beforeEnd	string	optional	Filter bookings with end before this date string.
afterCreatedAt	string	optional	Filter bookings that have been created after this date string.
beforeCreatedAt	string	optional	Filter bookings that have been created before this date string.
afterUpdatedAt	string	optional	Filter bookings that have been updated after this date string.
beforeUpdatedAt	string	optional	Filter bookings that have been updated before this date string.
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.
sortCreated	string	optional	Sort results by their creation time (when booking was made) in ascending or descending order.
sortUpdatedAt	string	optional	Sort results by their updated time (for example when booking status changes) in ascending or descending order.
take	number	optional	The number of items to return
skip	number	optional	The number of items to skip
teamId	number	required	—

POST

cal_com_teams_create_team

If accessed using an OAuth access token, the TEAM_PROFILE_WRITE scope is required.

/v2/teams

1 parameter

Param	Type	Required	Description
body	object	required	—

DELETE

cal_com_teams_delete_team

If accessed using an OAuth access token, the TEAM_PROFILE_WRITE scope is required.

/v2/teams/{teamId}

1 parameter

Param	Type	Required	Description
teamId	number	required	—

POST

cal_com_teams_event_types_create_phone_call

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}/create-phone-call

3 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
body	object	required	—

POST

cal_com_teams_event_types_create_team_event_type

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/teams/{teamId}/event-types

2 parameters

Param	Type	Required	Description
teamId	number	required	—
body	object	required	—

DELETE

cal_com_teams_event_types_delete_team_event_type

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}

2 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—

GET

cal_com_teams_event_types_get_team_event_type

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_READ scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}

2 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—

GET

cal_com_teams_event_types_get_team_event_types

Use the optional sortCreatedAt query parameter to order results by creation date (by ID). Accepts "asc" (oldest first) or "desc" (newest first). When not provided, no explicit ordering is applied.

/v2/teams/{teamId}/event-types

4 parameters

Param	Type	Required	Description
teamId	number	required	—
eventSlug	string	optional	Slug of team event type to return.
hostsLimit	number	optional	Specifies the maximum number of hosts to include in the response. This limit helps optimize performance. If not provided, all Hosts will be fetched.
sortCreatedAt	string	optional	Sort event types by creation date. When not provided, no explicit ordering is applied.

PATCH

cal_com_teams_event_types_update_team_event_type

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}

3 parameters

Param	Type	Required	Description
teamId	number	required	—
eventTypeId	number	required	—
body	object	required	—

POST

cal_com_teams_event_types_webhooks_create_team_event_type_webhook

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks

3 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
teamId	number	required	—
body	object	required	—

DELETE

cal_com_teams_event_types_webhooks_delete_all_team_event_type_webhooks

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks

2 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
teamId	number	required	—

DELETE

cal_com_teams_event_types_webhooks_delete_team_event_type_webhook

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId}

3 parameters

Param	Type	Required	Description
webhookId	string	required	—
eventTypeId	number	required	—
teamId	number	required	—

GET

cal_com_teams_event_types_webhooks_get_team_event_type_webhook

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_READ scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId}

3 parameters

Param	Type	Required	Description
webhookId	string	required	—
eventTypeId	number	required	—
teamId	number	required	—

GET

cal_com_teams_event_types_webhooks_get_team_event_type_webhooks

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_READ scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks

4 parameters

Param	Type	Required	Description
eventTypeId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
teamId	number	required	—

PATCH

cal_com_teams_event_types_webhooks_update_team_event_type_webhook

If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.

/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId}

4 parameters

Param	Type	Required	Description
webhookId	string	required	—
eventTypeId	number	required	—
teamId	number	required	—
body	object	required	—

GET

cal_com_teams_get_team

If accessed using an OAuth access token, the TEAM_PROFILE_READ scope is required.

/v2/teams/{teamId}

1 parameter

Param	Type	Required	Description
teamId	number	required	—

GET

cal_com_teams_get_teams

If accessed using an OAuth access token, the TEAM_PROFILE_READ scope is required.

/v2/teams

POST

cal_com_teams_invite_create_invite

If accessed using an OAuth access token, the TEAM_MEMBERSHIP_WRITE scope is required.

/v2/teams/{teamId}/invite

1 parameter

Param	Type	Required	Description
teamId	number	required	—

POST

cal_com_teams_memberships_create_team_membership

If accessed using an OAuth access token, the TEAM_MEMBERSHIP_WRITE scope is required.

/v2/teams/{teamId}/memberships

2 parameters

Param	Type	Required	Description
teamId	number	required	—
body	object	required	—

DELETE

cal_com_teams_memberships_delete_team_membership

/v2/teams/{teamId}/memberships/{membershipId}

2 parameters

Param	Type	Required	Description
teamId	number	required	—
membershipId	number	required	—

GET

cal_com_teams_memberships_get_team_membership

If accessed using an OAuth access token, the TEAM_MEMBERSHIP_READ scope is required.

/v2/teams/{teamId}/memberships/{membershipId}

2 parameters

Param	Type	Required	Description
teamId	number	required	—
membershipId	number	required	—

GET

cal_com_teams_memberships_get_team_memberships

Retrieve team memberships with optional filtering by email addresses. Supports pagination. If accessed using an OAuth access token, the TEAM_MEMBERSHIP_READ scope is required.

/v2/teams/{teamId}/memberships

4 parameters

Param	Type	Required	Description
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
emails	array	optional	Filter team memberships by email addresses. If you want to filter by multiple emails, separate them with a comma (max 20 emails for performance).

PATCH

cal_com_teams_memberships_update_team_membership

If accessed using an OAuth access token, the TEAM_MEMBERSHIP_WRITE scope is required.

/v2/teams/{teamId}/memberships/{membershipId}

3 parameters

Param	Type	Required	Description
teamId	number	required	—
membershipId	number	required	—
body	object	required	—

POST

cal_com_teams_ooo_create_team_member_ooo

If accessed using an OAuth access token, the TEAM_SCHEDULE_WRITE scope is required.

/v2/teams/{teamId}/users/{userId}/ooo

3 parameters

Param	Type	Required	Description
teamId	number	required	—
userId	number	required	—
body	object	required	—

DELETE

cal_com_teams_ooo_delete_team_member_ooo

If accessed using an OAuth access token, the TEAM_SCHEDULE_WRITE scope is required.

/v2/teams/{teamId}/users/{userId}/ooo/{oooId}

3 parameters

Param	Type	Required	Description
teamId	number	required	—
oooId	number	required	—
userId	integer	required	Required userId path parameter

GET

cal_com_teams_ooo_get_team_member_ooo

If accessed using an OAuth access token, the TEAM_SCHEDULE_READ scope is required.

/v2/teams/{teamId}/users/{userId}/ooo

6 parameters

Param	Type	Required	Description
teamId	number	required	—
userId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.

PATCH

cal_com_teams_ooo_update_team_member_ooo

If accessed using an OAuth access token, the TEAM_SCHEDULE_WRITE scope is required.

/v2/teams/{teamId}/users/{userId}/ooo/{oooId}

4 parameters

Param	Type	Required	Description
teamId	number	required	—
userId	number	required	—
oooId	number	required	—
body	object	required	—

POST

cal_com_teams_routing_forms_responses_create_routing_form_response

Only available for teams that are not part of an organization - for a team within an organization use the organization team endpoint instead. Required membership role: team member. PBAC permission: routingForm.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_ROUTING_FORM_WRITE scope is required.

/v2/teams/{teamId}/routing-forms/{routingFormId}/responses

10 parameters

Param	Type	Required	Description
routingFormId	string	required	—
start	string	required	Time starting from which available slots should be checked. Must be in UTC timezone as ISO 8601 datestring. You can pass date without hours which defaults to start of day or specify hours: 2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z
end	string	required	Time until which available slots should be checked. Must be in UTC timezone as ISO 8601 datestring. You can pass date without hours which defaults to end of day or specify hours: 2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z
timeZone	string	optional	Time zone in which the available slots should be returned. Defaults to UTC.
duration	number	optional	If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.
format	string	optional	Format of slot times in response. Use 'range' to get start and end times.
bookingUidToReschedule	string	optional	The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.
rescheduleWithSameHost	boolean	optional	Only for round robin event types that allow the person rescheduling to choose the host. True returns slots of the original host, false returns slots of any available host. Ignored for other event types.
queueResponse	boolean	optional	Whether to queue the form response.
teamId	number	required	—

GET

cal_com_teams_schedules_get_team_schedules

If accessed using an OAuth access token, the TEAM_SCHEDULE_READ scope is required.

/v2/teams/{teamId}/schedules

3 parameters

Param	Type	Required	Description
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

PATCH

cal_com_teams_update_team

If accessed using an OAuth access token, the TEAM_PROFILE_WRITE scope is required.

/v2/teams/{teamId}

2 parameters

Param	Type	Required	Description
teamId	number	required	—
body	object	required	—

GET

cal_com_teams_verified_resources_get_verified_email_by_id

If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_READ scope is required.

/v2/teams/{teamId}/verified-resources/emails/{id}

2 parameters

Param	Type	Required	Description
id	number	required	—
teamId	number	required	—

GET

cal_com_teams_verified_resources_get_verified_emails

If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_READ scope is required.

/v2/teams/{teamId}/verified-resources/emails

3 parameters

Param	Type	Required	Description
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_teams_verified_resources_get_verified_phone_by_id

If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_READ scope is required.

/v2/teams/{teamId}/verified-resources/phones/{id}

2 parameters

Param	Type	Required	Description
teamId	number	required	—
id	number	required	—

GET

cal_com_teams_verified_resources_get_verified_phone_numbers

If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_READ scope is required.

/v2/teams/{teamId}/verified-resources/phones

3 parameters

Param	Type	Required	Description
teamId	number	required	—
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

POST

cal_com_teams_verified_resources_request_email_verification_code

Sends a verification code to the Email. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_WRITE scope is required.

/v2/teams/{teamId}/verified-resources/emails/verification-code/request

2 parameters

Param	Type	Required	Description
teamId	number	required	—
body	object	required	—

POST

cal_com_teams_verified_resources_request_phone_verification_code

Sends a verification code to the phone number. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_WRITE scope is required.

/v2/teams/{teamId}/verified-resources/phones/verification-code/request

2 parameters

Param	Type	Required	Description
teamId	number	required	—
body	object	required	—

POST

cal_com_teams_verified_resources_verify_email

Use code to verify an email. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_WRITE scope is required.

/v2/teams/{teamId}/verified-resources/emails/verification-code/verify

2 parameters

Param	Type	Required	Description
teamId	number	required	—
body	object	required	—

POST

cal_com_teams_verified_resources_verify_phone_number

Use code to verify a phone number. If accessed using an OAuth access token, the TEAM_VERIFIED_RESOURCES_WRITE scope is required.

/v2/teams/{teamId}/verified-resources/phones/verification-code/verify

2 parameters

Param	Type	Required	Description
teamId	number	required	—
body	object	required	—

POST

cal_com_user_ooo_create_my_ooo

If accessed using an OAuth access token, the SCHEDULE_WRITE scope is required.

/v2/me/ooo

1 parameter

Param	Type	Required	Description
body	object	required	—

DELETE

cal_com_user_ooo_delete_my_ooo

If accessed using an OAuth access token, the SCHEDULE_WRITE scope is required.

/v2/me/ooo/{oooId}

1 parameter

Param	Type	Required	Description
oooId	number	required	—

GET

cal_com_user_ooo_get_my_ooo

If accessed using an OAuth access token, the SCHEDULE_READ scope is required.

/v2/me/ooo

4 parameters

Param	Type	Required	Description
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip
sortStart	string	optional	Sort results by their start time in ascending or descending order.
sortEnd	string	optional	Sort results by their end time in ascending or descending order.

PATCH

cal_com_user_ooo_update_my_ooo

If accessed using an OAuth access token, the SCHEDULE_WRITE scope is required.

/v2/me/ooo/{oooId}

2 parameters

Param	Type	Required	Description
oooId	number	required	—
body	object	required	—

GET

cal_com_user_verified_resources_get_verified_email_by_id

If accessed using an OAuth access token, the VERIFIED_RESOURCES_READ scope is required.

/v2/verified-resources/emails/{id}

1 parameter

Param	Type	Required	Description
id	number	required	—

GET

cal_com_user_verified_resources_get_verified_emails

If accessed using an OAuth access token, the VERIFIED_RESOURCES_READ scope is required.

/v2/verified-resources/emails

2 parameters

Param	Type	Required	Description
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

GET

cal_com_user_verified_resources_get_verified_phone_by_id

If accessed using an OAuth access token, the VERIFIED_RESOURCES_READ scope is required.

/v2/verified-resources/phones/{id}

1 parameter

Param	Type	Required	Description
id	number	required	—

GET

cal_com_user_verified_resources_get_verified_phone_numbers

If accessed using an OAuth access token, the VERIFIED_RESOURCES_READ scope is required.

/v2/verified-resources/phones

2 parameters

Param	Type	Required	Description
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

POST

cal_com_user_verified_resources_request_email_verification_code

Sends a verification code to the email. If accessed using an OAuth access token, the VERIFIED_RESOURCES_WRITE scope is required.

/v2/verified-resources/emails/verification-code/request

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_user_verified_resources_request_phone_verification_code

Sends a verification code to the phone number. If accessed using an OAuth access token, the VERIFIED_RESOURCES_WRITE scope is required.

/v2/verified-resources/phones/verification-code/request

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_user_verified_resources_verify_email

Use code to verify an email. If accessed using an OAuth access token, the VERIFIED_RESOURCES_WRITE scope is required.

/v2/verified-resources/emails/verification-code/verify

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_user_verified_resources_verify_phone_number

Use code to verify a phone number. If accessed using an OAuth access token, the VERIFIED_RESOURCES_WRITE scope is required.

/v2/verified-resources/phones/verification-code/verify

1 parameter

Param	Type	Required	Description
body	object	required	—

POST

cal_com_webhooks_create_webhook

If accessed using an OAuth access token, the WEBHOOK_WRITE scope is required.

/v2/webhooks

1 parameter

Param	Type	Required	Description
body	object	required	—

DELETE

cal_com_webhooks_delete_webhook

If accessed using an OAuth access token, the WEBHOOK_WRITE scope is required.

/v2/webhooks/{webhookId}

1 parameter

Param	Type	Required	Description
webhookId	string	required	—

GET

cal_com_webhooks_get_webhook

If accessed using an OAuth access token, the WEBHOOK_READ scope is required.

/v2/webhooks/{webhookId}

1 parameter

Param	Type	Required	Description
webhookId	string	required	—

GET

cal_com_webhooks_get_webhooks

Gets a paginated list of webhooks for the authenticated user. If accessed using an OAuth access token, the WEBHOOK_READ scope is required.

/v2/webhooks

2 parameters

Param	Type	Required	Description
take	number	optional	Maximum number of items to return
skip	number	optional	Number of items to skip

PATCH

cal_com_webhooks_update_webhook

If accessed using an OAuth access token, the WEBHOOK_WRITE scope is required.

/v2/webhooks/{webhookId}

2 parameters

Param	Type	Required	Description
webhookId	string	required	—
body	object	required	—

Request private-beta access