SavvyCal Appointments Developer Docs
Build on top of SavvyCal Appointments with our REST API, embeddable UI components, and webhooks.
Getting started
- Authentication — set up API tokens and authenticate requests.
- Platforms — for multi-tenant apps managing multiple accounts.
- Data Model — overview of core resource types (providers, services, appointments, etc.).
Concepts
- Platforms — multi-tenant account management.
- Data Model — core resource types and their relationships.
- Users and Accounts — identity, tenancy boundaries, and roles.
- Connected Accounts — integrating external calendar and conferencing providers.
- Booking Intents — multi-step booking lifecycle with slot holding.
- Slot Availability — how available time slots are calculated and queried.
- Working with Dates — date and time formats used in the API.
- Metadata Filtering — filtering API results by metadata.
REST API
The SavvyCal Appointments API adheres to REST conventions. Our API communicates in JSON format and uses bearer tokens to authenticate requests. We take an additive approach; new fields may be added to existing payload types as we expand the API.
The full OpenAPI specification for the REST API can be found here: https://api.savvycal.app/v1/spec
Components
Copy-and-paste React components for weaving scheduling UI into your app.
Embedding
Embed the booking UI on your website with a web component.
Webhooks
Listen for changes in a SavvyCal account and get notified via HTTP POST requests.
Changelog
A log of API changes, including new endpoints, fields, and breaking changes.