# SavvyCal Appointments

> Build on top of SavvyCal Appointments with our REST API, embeddable UI components, and webhooks.

- [SavvyCal Appointments Developer Docs](/index.md): Build on top of SavvyCal Appointments with our REST API, embeddable UI components, and webhooks.


## Authentication

- [Authentication](/authentication.md): The SavvyCal REST API is authenticated via bearer tokens. To make authenticated requests, include the API token in the Authorization header:

## Booking Intents

- [Booking Intents](/booking-intents.md): A BookingIntent tracks the lifecycle of a multi-step booking attempt, enabling slot holding and progressive data collection before creating an appointment.

## Changelog

- [API Changelog](/changelog.md): A log of notable changes to the SavvyCal Appointments API.

## Components

- [Components](/components.md): SavvyCal Components are designed to be copied and pasted directly into your application, similar to modern UI kits like Catalyst and shadcn. This allows you to weave SavvyCal-powered functionality seamlessly into your existing UI, without resorting to messy CSS overrides to force third-party elements to look like your own.
- [Public Booking Form](/components/public-booking-form.md): A basic public booking form component.

## Connected Accounts

- [Connected Accounts](/connected-accounts.md): This guide explains how connected accounts integrate external calendar and conferencing providers with SavvyCal, how users connect them, and how to monitor and respond to connection health changes.

## Data Model

- [Data Model](/data-model.md): This guide introduces the core resource types available in SavvyCal Appointments to help you plan your integration.

## Dates

- [Working with Dates](/dates.md): The SavvyCal API uses string-based date and time values in several formats. Understanding these formats — and the differences between how dates appear in responses versus requests — will help you integrate correctly.

## Embedding

- [Booking Embed](/embedding/booking-embed.md): The booking embed lets you display the SavvyCal appointment booking experience directly on your website. It's a small, SavvyCal-hosted web component that wraps an `` pointing at a booking URL. The booking interface runs inside the iframe; the component handles sizing, theming, and lifecycle events.
- [Booking Embed (v1)](/embedding/booking-embed-v1.md): A newer version of the booking embed is available. See Booking Embed for the current component. This page documents the previous `` component, which remains supported.

## Idempotency

- [Idempotency](/idempotency.md): Network blips and timeouts make it easy to accidentally retry the same request twice — and on unsafe operations like creating a booking intent or completing an appointment, that retry can produce duplicate side effects (a double-booked slot, a duplicate charge). To make retries safe, the SavvyCal API accepts an Idempotency-Key header on unsafe (POST, PATCH, DELETE) endpoints.

## Metadata Filtering

- [Metadata Filtering](/metadata-filtering.md): Several API endpoints support filtering by metadata using query parameters with bracket notation.

## Platforms

- [Platforms](/platforms.md): This guide explains the platform model in SavvyCal Appointments: how platforms manage multiple accounts, authenticate with the API, and operate on behalf of individual accounts.

## Rate Limiting

- [Rate Limiting](/rate-limiting.md): The SavvyCal API enforces rate limits to protect against abuse and ensure fair usage across all consumers.

## Slot Availability

- [Slot Availability](/slot-availability.md): This guide explains how SavvyCal calculates available time slots for a service and how to query them through the API.

## Users And Accounts

- [Users and Accounts](/users-and-accounts.md): This guide explains the identity and access model in SavvyCal Appointments: how users authenticate, how accounts provide tenancy boundaries, and how these concepts relate to providers and connected calendar accounts.

## Webhooks

- [Webhooks](/webhooks.md): Registering a webhook

## Optional
- [API Specification](https://api.savvycal.app/v1/spec): Complete OpenAPI spec for the SavvyCal Appointments REST API