Cal

Initiates or checks the external connection status for a specified calendar, possibly returning a redirect url for user authorization to complete integration, without altering calendar data.

Creates a new team profile, or updates one if a 'slug' matches, customizing branding, scheduling, privacy, and operational details.

Retrieves all organization ids associated with the currently authenticated user.

Retrieves all teams the user belongs to, including their names and members.

Retrieves cal event types, filterable by `username` (required if `eventslug` is provided), multiple `usernames`, or organization details (`orgslug` or `orgid`).

Temporarily reserves an available time slot for an existing and bookable event type, useful for high-demand slots to prevent double-bookings while the user completes the booking.

To find busy calendar slots for scheduling/conflict detection, call this with a valid `credentialid`, an `externalid` accessible by it, and a recognized iana `loggedinuserstz`; returns only busy intervals, not event details or free slots.

Retrieves a list of all calendar summaries (no event details) associated with the authenticated user's account.

Retrieves the authenticated user's core profile information (e.g., name, email, timezone); does not retrieve related data like calendar events or schedules.

Retrieves a list of memberships, detailing member roles and statuses, for an existing team specified by `teamid`, with support for pagination.

Retrieves users associated with a specific organization id, excluding individual scheduling or calendar data; the `orgid` must be a valid identifier for an existing organization.

Adds a new member to a specified team within an organization by creating a team membership.

Adds a new option to an organization's attribute, requiring a display `value` and a `slug` unique for that attribute.

Cancels an existing and active cal.com booking using its unique identifier (uid).

Retrieves free/busy availability for a specified calendar to aid scheduling without revealing event details; requires an existing, accessible calendar, noting that data granularity can vary.

Call this read-only action to verify the connection and synchronization status of a user's google calendar integration with cal.

Checks an ics feed url (expected as a query parameter) to verify its validity, accessibility, and icalendar data integrity.

Verifies if stripe is correctly connected to the cal scheduling system and functional for processing payments, reporting only on the integration's status.

Retrieves the stripe integration status and related information for a team, primarily to verify account connection, subscription details, or payment setup; this is a read-only operation that does not modify stripe settings.

Confirms an existing booking by `bookinguid` if the booking exists and is in a state allowing confirmation (e.g., not already cancelled or confirmed); this finalizes the booking, does not modify its details, and should typically be performed once.

Creates a new membership or updates an existing one for a user within an organization; the user specified by userid must already exist in the system.

Creates a new managed user for an oauth client, setting profile and scheduling preferences; if `timezone` is not provided, a default schedule (mon-fri, 9am-5pm) is not created, requiring manual setup via `/schedules` endpoint before bookings are possible.

Creates a webhook for an existing oauth client to send real-time cal.com event notifications (e.g., `booking created`, `meeting ended`) to the `subscriberurl`, enabling integration with external systems or workflow automation.

Creates a new custom attribute for an existing organization, used to enhance data collection for event bookings or user profiles.

Creates a webhook for a specified, existing organization, sending notifications for selected trigger events to a designated, publicly accessible subscriber url that accepts post requests.

Schedules a phone call event in cal.com using existing eventtype, organization, and team ids; this action only registers the event details and does not initiate the actual phone call.

Creates a phone call template associated with an existing event type and team, for defining reusable call configurations like numbers and scripts; note this does not initiate an actual call.

Creates a new event type for a specified team in cal.com; ensure `teamid`, any provided `scheduleid`, `hosts.userid`, and `destinationcalendar` details are valid and accessible.

Creates a highly customizable cal.com team event type with extensive scheduling, booking, and host assignment options; `lengthinminutes` (as string) must be included in `lengthinminutesoptions`, destination calendar details (from `/api/v2/calendars`) must be valid, and host user ids must be valid team members.

Creates a new team with customizable attributes within an existing and accessible cal.com organization specified by orgid.

Adds a user to a team with a specified role, acceptance status, and impersonation settings; ensure `teamid` and `userid` refer to existing, valid entities.

Creates a cal.com user availability schedule, defining its name, timezone, weekly recurring availability, and specific date overrides; if `isdefault` is true, this schedule replaces any existing default and applies to event types not linked to a specific schedule.

Creates a new schedule defining a user's availability with weekly slots and date-specific overrides in an organization; setting 'isdefault' to true may replace an existing default schedule for the user.

Creates a webhook for an existing `eventtypeid` in cal.com, sending notifications for specified `triggers` to a `subscriberurl` that handles post requests.

Declines a pending booking using its bookinguid, optionally with a reason; this action is irreversible and applies only to bookings awaiting confirmation.

Disconnects the specified conferencing application (e.g., 'zoom', 'google meet') for the cal.com account, immediately terminating any ongoing call or meeting; use with caution.

Permanently deletes an existing event type by its id, which invalidates its scheduling links; the operation is irreversible, and while existing bookings are unaffected, no new bookings can be made for this event type.

Permanently removes an event type's configuration from a team's scheduling options (e.g., for cleanup); this action is irreversible and requires the event type to be associated with the team.

Use to permanently remove a user's membership from a specific team within an organization, which revokes their team-associated access but does not remove them from the organization.

Irreversibly revokes a specific user's association with a given oauth client, without deleting the user's cal account.

Permanently deletes a specific webhook subscription of an oauth client in the cal application, stopping its notifications.

Permanently deletes an existing attribute (specified by `attributeid`) from an existing organization (specified by `orgid`); this action is irreversible and may affect features dependent on the attribute.

Permanently deletes a specified option from an organization's attribute, typically to remove an unnecessary configuration choice.

Irreversibly deletes a user's membership from an organization, removing all associated access and permissions; the response confirms deletion without returning details of the deleted membership.

Permanently deletes an organization's webhook, which stops all its notifications; this action is irreversible and the webhook cannot be recovered.

Permanently deletes a specific schedule using its unique identifier, which must correspond to an existing schedule.

Removes a specified, currently selected calendar from the user's active list within the application, without deleting it from the external provider.

Deletes a previously selected time slot from the cal schedule using its `uid`; the slot must exist and this action is irreversible.

Permanently and irreversibly deletes an existing team and all its associated data from the cal system, using the team's unique `teamid`.

Permanently and irreversibly deletes a specific team (and all its associated data, members, and linked projects/events) from an organization, when the team is no longer needed or during organizational restructuring.

Irreversibly removes a user's team membership in the cal application, revoking access to that specific team; the user's overall cal account remains active.

Removes a custom attribute option (e.g., skill, role) currently assigned to a user within an organization; this operation is irreversible.

Permanently removes a user from a specific organization (user's system-wide account is unaffected), revoking their access rights therein; this action is irreversible via api and expects the user to be a current member.

Permanently deletes a specific user's schedule, provided the organization, user, and schedule (identified by `orgid`, `userid`, and `scheduleid`) exist.

Call this to irreversibly delete all webhooks for a specific `eventtypeid` if the event type exists; details of deleted webhooks are not returned.

Permanently deletes an existing webhook by its `webhookid`, stopping future notifications; this action is irreversible.

Permanently deletes a specific webhook for an event type, halting its real-time notifications; this operation is irreversible and leaves the event type and other webhooks untouched.

Disconnects a calendar integration by its provider name and credential id, irreversibly revoking cal's access; external calendar data remains unaffected.

Fetches a list of bookings, optionally filtered by status, attendee, date range, or by event/team ids (which must belong to/include the authenticated user respectively), with support for pagination and sorting.

Fetches all configuration settings and characteristics for a single event type (identified by orgid, teamid, and eventtypeid), which must exist and be accessible; this read-only action cannot list, create, or modify event types.

Retrieves a specific attribute of an organization, useful for fetching a single data point instead of the entire organization record.

Fetches an oauth access token for the specified `clientid` to authenticate api calls; this action only retrieves the token, not managing scheduling or calendar events.

Fetches comprehensive details for a specific, existing schedule using its `scheduleid`.

Fetches a specific user's schedule, potentially including events and availability, using `orgid`, `userid`, and `scheduleid`.

Retrieves details for a single, specific webhook using its `webhookid` and associated `eventtypeid`.

Forces an immediate refresh of oauth tokens for a specified user and client, bypassing the normal expiration cycle, typically when existing tokens are suspected to be invalid or fresh credentials are required; ensure the user exists, the client is registered, and prior authorization is valid.

Retrieves all supported time zone identifiers (e.g., 'america/new york', 'europe/london') and their associated metadata, excluding specific dst changes or precise utc offset details.

Retrieves available time slots for scheduling by considering existing bookings and availability, based on criteria like a specified time range and event type.

Generates an oauth 2.0 authorization url for a supported conferencing `app` to initiate or refresh its integration with cal.com.

Retrieves the cal system's global default schedule configuration, not custom or user-specific ones.

Retrieves a specific event type by its id, requiring that the event type is associated with the given team id.

Generates the initial google calendar oauth 2.0 authorization url for user redirection to begin the authentication and authorization process.

Retrieves users associated with a specific oauth client (identified by a valid `clientid`) for auditing access or managing permissions.

Retrieves a list of schedules (e.g., events, appointments) for an organization, providing basic schedule information, not detailed individual event data.

Retrieves event types, including names, durations, and custom settings for team scheduling, for all teams within an existing organization specified by `orgid`.

Fetches all schedule information for a specific user within an organization; handle potential pagination for extensive schedules.

Fetches all scheduled events or appointments for a specified user within their team and organization.

Retrieves stripe connect account details (id, charges/payouts status, verification, settings) for the user's linked cal.com account; response may be empty or indicate no integration if no account is linked.

Retrieves comprehensive details (e.g., members, roles, metadata) for a specific team using its `teamid` within an organization specified by `orgid`.

Fetches comprehensive details for an existing team using its unique id; returned fields may vary by team configuration and user permissions.

Retrieves details for an existing and accessible webhook by its id; this is a read-only operation.

Processes an oauth 2.0 callback for a conferencing `app`, exchanging the `code` and `state` for access credentials; ensure an oauth flow was previously initiated.

Retrieves all memberships for a given organization, including user details, roles, status, and membership dates.

Retrieves all event types for a specific team within an organization, optionally filtering by a specific event slug.

Marks the host and/or specified attendees as absent for an existing booking, typically used after a scheduled event to record no-shows.

Updates an organization membership's status (accepted), role, or impersonation settings, identified by `orgid` and `membershipid` in the path; requires at least one of these fields in the request to apply changes.

Partially updates an organization attribute using `orgid` and `attributeid`, allowing modification of its name, slug, type, or enabled status; changing the 'type' may affect existing data.

Partially updates a specific option for an organization's attribute, modifying its 'value' and/or 'slug'; at least one of 'value' or 'slug' must be provided.

Partially updates details for a user that exists within the specified organization.

Updates specified details for an existing team identified by `teamid`; unspecified fields remain unchanged.

Updates configuration (e.g., payload template, active status, url, triggers, secret) for an existing webhook tied to a specific event type.

Use to submit/update authentication credentials (passed in the request body) for an existing calendar, enabling cal to connect with external calendar services for synchronization.

Connects or reconnects cal.com with a specified conferencing application to enable future virtual meeting scheduling, but does not itself create or schedule meetings.

Creates a new booking for an active event type, scheduling it for a specified start time (preferably in the future) with primary attendee details and optional customizations.

Assigns an existing attribute option (using `attributeoptionid`) or creates a new one (using `value`) for a user, linking it to a specified `attributeid` which must already exist within the organization.

Links a new external calendar or updates an existing link to one, enabling synchronization with the cal application by specifying the `integration` provider, the calendar's `externalid`, and the `credentialid`.

Adds a new user to an existing organization (identified by `orgid` in path), requiring user's `email` and allowing extensive optional profile customization.

Creates a new cal.com webhook subscription to send real-time notifications for specified calendar events to a publicly accessible subscriber url.

Reassigns an existing, active booking to a specified, authorized user; does not notify participants of this change.

Reassigns the specified booking to a new team member, who is determined by the system rather than being specified in the request.

Refreshes an oauth access token for a specified `clientid` and managed user using their `refreshtoken`, enabling continued api access when the current token is near or past expiry.

Reschedules an existing booking (identified by `bookinguid`) to a new time, provided the new slot's availability is confirmed beforehand; all other rescheduling parameters (e.g., new date, time) must be sent in the post request body, not via this action's direct parameters.

Retrieves all available options for a specific attribute within a designated organization, requiring valid and associated `orgid` and `attributeid`.

Fetches comprehensive details for an existing booking, identified by its `bookinguid`.

Retrieves details of the team(s) for the currently authenticated user within the specified organization `orgid`.