# 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 component allows you to display the appointment booking UI seamlessly on your website. Under the covers, the booking embed uses a custom web component that is defined by a small, SavvyCal-hosted JavaScript library.

## 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.

## 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