Request an invite
Appointer API · v1Beta

Build integrations on Appointer.

A REST API and signed webhooks for everything in your account — appointments, clients, services, staff and locations. Read, write, and react in real time.

Keys are issued in Settings → Developer · tenant-scoped · shown once
The API is in Beta. Endpoints are stable and safe to build on — we'll give advance notice before any breaking change.
Idempotency built in
Real-time webhooks
$ curl https://api.appointer.co/v1/appointments \
     -H "Authorization: Bearer ak_live_…"
     -H "Accept: application/json" ▋
Base URL
api.appointer.co/v1
One host, all endpoints
Transport
TLS 1.2+
HTTPS required on every call
Versioning
v1 · stable
Breaking changes ship a new version
Rate limit
10,000 / hr
Per workspace · 429 with Retry-After
Authentication

Bearer keys, scoped to one workspace.

Authenticate every request with a secret API key in the Authorization header. Generate one from Settings → Developer — it can only read and write data inside that workspace.

Tenant-scoped. A key never reaches beyond the workspace that issued it.
Shown once. The full secret appears a single time, at creation. Store it server-side.
Revocable. Roll or revoke a key instantly — old keys 401 immediately.
request headers
# every request carries a tenant-scoped bearer token
Authorization: Bearer ak_live_AbCd3f9K2mQ7xR1pN8sV4tZ6wY0jL5hT
Never ship a secret key in client-side code or a public repo. Use the embeddable booking widget for browser contexts.
What you can build

From one calendar to a whole platform.

The API exposes the same entities you work with every day — appointments, clients, services, staff and locations.

Custom booking widget

Pull live availability and create appointments straight from your own website or app.

CRM sync

Mirror clients and their full appointment history into HubSpot, Salesforce or your own CRM.

Analytics & BI export

Stream appointments, revenue and no-shows into your warehouse, Looker or a finance sheet.

Custom notifications

React to webhooks to fire your own SMS, Slack pings or post-visit follow-ups.

AI assistant booking

Let an assistant read open slots and book on a client's behalf, then confirm over chat.

Multi-location ops

Manage staff working hours and roll multiple locations' calendars up to one dashboard.

Webhooks

Real-time, and signed.

Register an endpoint and Appointer POSTs a JSON payload the moment an event fires. Every delivery is signed with a per-endpoint secret in the X-Appointer-Signature header — recompute the HMAC-SHA256 of the raw body and compare in constant time to confirm it came from us.

Event
When it fires
appointment.created
A booking is created on any channel — page, embed, or admin.
appointment.cancelled
A client or staff member cancels a booking.
appointment.rescheduled
An existing booking moves to a new time or staff member.
appointment.completed
An appointment is marked done and checked out.
appointment.no_show
A client fails to arrive and the slot is flagged.
Full reference

Every endpoint, documented.

Browse the complete OpenAPI reference — request and response schemas, error codes, pagination and idempotency, plus the full webhook event catalog.