---
title: "API reference — Caly"
description: "Caly REST API reference: bookings, event types, schedules, availability slots, calendars and webhooks. Authenticate with an API key from your Caly settings."
url: https://trycaly.com/docs/api/
---

Developers

# Caly API

Everything you can do in Caly, over REST. Create an API key under **Settings → Developer → API keys** and send it as `Authorization: Bearer <key>`. The base URL is `https://api.trycaly.com`; every endpoint lives under `/v2`.

## Endpoints

Base URL: https://api.trycaly.com. Authenticate with `Authorization: Bearer <api key>`. Full request and response schemas: https://trycaly.com/docs/openapi.json

### Api Keys

- `POST /v2/api-keys/refresh`: Refresh API Key

### Bookings

- `POST /v2/bookings`: Create a booking
- `GET /v2/bookings`: Get all bookings
- `GET /v2/bookings/by-seat/{seatUid}`: Get a booking by seat UID
- `GET /v2/bookings/{bookingUid}`: Get a booking
- `GET /v2/bookings/{bookingUid}/recordings`: Get all the recordings for the booking
- `GET /v2/bookings/{bookingUid}/transcripts`: Get Cal Video real time transcript download links for the booking
- `POST /v2/bookings/{bookingUid}/reschedule`: Reschedule a booking
- `POST /v2/bookings/{bookingUid}/cancel`: Cancel a booking
- `POST /v2/bookings/{bookingUid}/mark-absent`: Mark a booking absence
- `POST /v2/bookings/{bookingUid}/reassign`: Reassign a booking to auto-selected host
- `POST /v2/bookings/{bookingUid}/reassign/{userId}`: Reassign a booking to a specific host
- `POST /v2/bookings/{bookingUid}/confirm`: Confirm a booking
- `POST /v2/bookings/{bookingUid}/decline`: Decline a booking
- `GET /v2/bookings/{bookingUid}/calendar-links`: Get 'Add to Calendar' links for a booking
- `GET /v2/bookings/{bookingUid}/references`: Get booking references
- `GET /v2/bookings/{bookingUid}/conferencing-sessions`: Get Video Meeting Sessions. Only supported for Cal Video
- `PATCH /v2/bookings/{bookingUid}/location`: Update booking location for an existing booking

### Bookings / Attendees

- `GET /v2/bookings/{bookingUid}/attendees`: Get all attendees for a booking
- `POST /v2/bookings/{bookingUid}/attendees`: Add an attendee to a booking
- `GET /v2/bookings/{bookingUid}/attendees/{attendeeId}`: Get a specific attendee for a booking
- `DELETE /v2/bookings/{bookingUid}/attendees/{attendeeId}`: Remove an attendee from a booking

### Bookings / Guests

- `POST /v2/bookings/{bookingUid}/guests`: Add guests to an existing booking

### Unified Calendars

- `GET /v2/calendars/connections`: List calendar connections
- `GET /v2/calendars/connections/{connectionId}/events`: List events for a connection
- `POST /v2/calendars/connections/{connectionId}/events`: Create event on a connection
- `GET /v2/calendars/connections/{connectionId}/events/{eventId}`: Get event for a connection
- `PATCH /v2/calendars/connections/{connectionId}/events/{eventId}`: Update event for a connection
- `DELETE /v2/calendars/connections/{connectionId}/events/{eventId}`: Delete event for a connection
- `GET /v2/calendars/connections/{connectionId}/freebusy`: Get free/busy for a connection
- `GET /v2/calendars/{calendar}/events/{eventUid}`: Get meeting details from calendar
- `PATCH /v2/calendars/{calendar}/events/{eventUid}`: Update meeting details in calendar
- `DELETE /v2/calendars/{calendar}/events/{eventUid}`: Delete a calendar event
- `GET /v2/calendars/{calendar}/event/{eventUid}`: Get meeting details from calendar
- `PATCH /v2/calendars/{calendar}/event/{eventUid}`: Update meeting details in calendar
- `GET /v2/calendars/{calendar}/events`: List calendar events
- `POST /v2/calendars/{calendar}/events`: Create a calendar event
- `GET /v2/calendars/{calendar}/freebusy`: Get free/busy times

### Calendars

- `POST /v2/calendars/ics-feed/save`: Save an ICS feed
- `GET /v2/calendars/ics-feed/check`: Check an ICS feed
- `GET /v2/calendars/busy-times`: Get busy times
- `GET /v2/calendars`: Get all calendars
- `GET /v2/calendars/{calendar}/connect`: Get OAuth connect URL
- `GET /v2/calendars/{calendar}/save`: Save Google or Outlook calendar credentials
- `POST /v2/calendars/{calendar}/credentials`: Save Apple calendar credentials
- `GET /v2/calendars/{calendar}/check`: Check a calendar connection
- `POST /v2/calendars/{calendar}/disconnect`: Disconnect a calendar

### Conferencing

- `POST /v2/conferencing/{app}/connect`: Connect your conferencing application
- `GET /v2/conferencing/{app}/oauth/auth-url`: Get OAuth conferencing app auth URL
- `GET /v2/conferencing/{app}/oauth/callback`: Conferencing app OAuth callback
- `GET /v2/conferencing`: List your conferencing applications
- `POST /v2/conferencing/{app}/default`: Set your default conferencing application
- `GET /v2/conferencing/default`: Get your default conferencing application
- `DELETE /v2/conferencing/{app}/disconnect`: Disconnect your conferencing application

### Deprecated: Platform / Managed Users

- `GET /v2/oauth-clients/{clientId}/users`: Get all managed users
- `POST /v2/oauth-clients/{clientId}/users`: Create a managed user
- `GET /v2/oauth-clients/{clientId}/users/{userId}`: Get a managed user
- `PATCH /v2/oauth-clients/{clientId}/users/{userId}`: Update a managed user
- `DELETE /v2/oauth-clients/{clientId}/users/{userId}`: Delete a managed user
- `POST /v2/oauth-clients/{clientId}/users/{userId}/force-refresh`: Force refresh tokens
- `POST /v2/oauth/{clientId}/refresh`: Refresh managed user tokens

### Deprecated: Platform / Webhooks

- `POST /v2/oauth-clients/{clientId}/webhooks`: Create a webhook
- `GET /v2/oauth-clients/{clientId}/webhooks`: Get all webhooks
- `DELETE /v2/oauth-clients/{clientId}/webhooks`: Delete all webhooks
- `PATCH /v2/oauth-clients/{clientId}/webhooks/{webhookId}`: Update a webhook
- `GET /v2/oauth-clients/{clientId}/webhooks/{webhookId}`: Get a webhook
- `DELETE /v2/oauth-clients/{clientId}/webhooks/{webhookId}`: Delete a webhook

### Deprecated: Platform OAuth Clients

- `POST /v2/oauth-clients`: Create an OAuth client
- `GET /v2/oauth-clients`: Get all OAuth clients
- `GET /v2/oauth-clients/{clientId}`: Get an OAuth client
- `PATCH /v2/oauth-clients/{clientId}`: Update an OAuth client
- `DELETE /v2/oauth-clients/{clientId}`: Delete an OAuth client

### Destination Calendars

- `PUT /v2/destination-calendars`: Update destination calendars

### Event Types

- `POST /v2/event-types`: Create an event type
- `GET /v2/event-types`: Get all event types
- `GET /v2/event-types/{eventTypeId}`: Get an event type
- `PATCH /v2/event-types/{eventTypeId}`: Update an event type
- `DELETE /v2/event-types/{eventTypeId}`: Delete an event type

### Event Types / Webhooks

- `POST /v2/event-types/{eventTypeId}/webhooks`: Create a webhook
- `GET /v2/event-types/{eventTypeId}/webhooks`: Get all webhooks
- `DELETE /v2/event-types/{eventTypeId}/webhooks`: Delete all webhooks
- `PATCH /v2/event-types/{eventTypeId}/webhooks/{webhookId}`: Update a webhook
- `GET /v2/event-types/{eventTypeId}/webhooks/{webhookId}`: Get a webhook
- `DELETE /v2/event-types/{eventTypeId}/webhooks/{webhookId}`: Delete a webhook

### Event Types Private Links

- `POST /v2/event-types/{eventTypeId}/private-links`: Create a private link for an event type
- `GET /v2/event-types/{eventTypeId}/private-links`: Get all private links for an event type
- `PATCH /v2/event-types/{eventTypeId}/private-links/{linkId}`: Update a private link for an event type
- `DELETE /v2/event-types/{eventTypeId}/private-links/{linkId}`: Delete a private link for an event type

### Me

- `GET /v2/me`: Get my profile
- `PATCH /v2/me`: Update my profile

### OAuth2

- `GET /v2/auth/oauth2/clients/{clientId}`: Get OAuth2 client
- `POST /v2/auth/oauth2/token`: Exchange authorization code or refresh token for tokens

### Schedules

- `POST /v2/schedules`: Create a schedule
- `GET /v2/schedules`: Get all schedules
- `GET /v2/schedules/default`: Get default schedule
- `GET /v2/schedules/{scheduleId}`: Get a schedule
- `PATCH /v2/schedules/{scheduleId}`: Update a schedule
- `DELETE /v2/schedules/{scheduleId}`: Delete a schedule

### Selected Calendars

- `POST /v2/selected-calendars`: Add a selected calendar
- `DELETE /v2/selected-calendars`: Delete a selected calendar

### Slots

- `GET /v2/slots`: Get available time slots for an event type
- `POST /v2/slots/reservations`: Reserve a slot
- `GET /v2/slots/reservations/{uid}`: Get reserved slot
- `PATCH /v2/slots/reservations/{uid}`: Update a reserved slot
- `DELETE /v2/slots/reservations/{uid}`: Delete a reserved slot

### Stripe

- `GET /v2/stripe/connect`: Get Stripe connect URL
- `GET /v2/stripe/save`: Save Stripe credentials
- `GET /v2/stripe/check`: Check Stripe connection

### Verified Resources

- `POST /v2/verified-resources/emails/verification-code/request`: Request email verification code
- `POST /v2/verified-resources/phones/verification-code/request`: Request phone number verification code
- `POST /v2/verified-resources/emails/verification-code/verify`: Verify an email
- `POST /v2/verified-resources/phones/verification-code/verify`: Verify a phone number
- `GET /v2/verified-resources/emails`: Get list of verified emails
- `GET /v2/verified-resources/phones`: Get list of verified phone numbers
- `GET /v2/verified-resources/emails/{id}`: Get verified email by id
- `GET /v2/verified-resources/phones/{id}`: Get verified phone number by id

### Webhooks

- `POST /v2/webhooks`: Create a webhook
- `GET /v2/webhooks`: Get all webhooks
- `PATCH /v2/webhooks/{webhookId}`: Update a webhook
- `GET /v2/webhooks/{webhookId}`: Get a webhook
- `DELETE /v2/webhooks/{webhookId}`: Delete a webhook
