VoltsBook

DEV Building on it

Two lines, or the whole diary.

Most people want the booking page on a site they already have, and that is a copy and a paste. If you are building something on top, the same booking pipeline is available over HTTP with keys, idempotency and signed webhooks.

ENDPOINTS
48
WEBHOOK TOPICS
6
AUTH
Bearer key
SPEC
OpenAPI 3.1
MINUTES

Embed the booking page

Two lines of HTML on any site — WordPress, Squarespace, Webflow, a hand-written page. The widget sizes itself and needs no build step.

Embed guide
REST

The /v1 API

48 endpoints over bearer keys: read the catalog, ask what is free, hold a slot, take the booking. Every write goes through the same pipeline the booking page uses.

API reference
AGENTS

MCP for AI agents

Connect Claude or any MCP client to a business in one config line — every /v1 operation becomes a tool, derived from the same contract, so an agent can quote prices, offer slots and book. Voice agents included.

Agents & MCP
PUSH

Webhooks

6 signed topics delivered to your endpoint, with retries and automatic disabling when a destination stays broken.

Topics and signing

RULES What holds on the wire

Four things you can rely on.

One pipeline, whichever door
A booking made through the API takes the same advisory lock, the same in-transaction re-check and the same exclusion constraint as one made on the booking page. There is no faster path that skips a rule.
Money is integers
Every amount on the wire is a whole number of minor units — pence, cents — with the currency beside it. No decimal strings, no floats, and zero-decimal currencies handled in both directions.
Time is UTC, and spoken for you
Instants are RFC 3339 in UTC, and every slot and booking also carries the business-zone wall clock plus a ready-to-read `say` — "Saturday 22 August at 9:00 AM". Voice agents read `say` verbatim instead of converting; anything else renders where the customer is via the IANA zone from /v1/ping.
Retries cannot double-book
Writes take an idempotency key. Repeat a request and you get the original answer back rather than a second appointment — which matters most on the request you are least sure landed.

MAP What is there

The surface, in groups.

Full reference

Meta

2 endpoints

Check a key works and find out what this deployment can do before you build against it.

Catalog

13 endpoints

What is bookable: services with their durations and LIST prices, the people who perform them, and where. A list price is not a quote — price-preview under Bookings gives the figure a customer will actually be charged.

Availability

1 endpoint

The times a booking would actually be accepted. Computed from opening hours, the person, the service, holidays, blocked time and what is already booked — so a slot you are offered is one you can take.

Reservations

3 endpoints

Hold a slot briefly while a customer finishes deciding. A reservation is not a booking and expires on its own.

Bookings

6 endpoints

Quote a price, then create, read, reschedule and cancel appointments. Every write goes through the same pipeline the booking page uses, so nothing reached this way behaves differently — and price-preview runs the same pricing code the booking itself runs, so a quote and a charge cannot disagree.

Settings

15 endpoints

Booking rules, custom forms and the status vocabulary — full admin control for an agent whose key carries the settings.manage scope. Keys minted without it, including every key minted before scopes existed, are refused here and keep taking bookings exactly as before.

Flows

7 endpoints

The guided-booking wizard — cards, options, and the publish gate, for keys carrying the settings.manage scope. Publishing runs the same validator the panel’s editor runs, and a refusal returns the findings so an agent can repair the flow. The full lesson lives at /developers/flows.

Reports

1 endpoint

Appointment and revenue figures over a date range, for keys carrying the reports.read scope. The same series the panel’s own reports draw.

Take your first booking today.

Free plan, no card, and your trade already set up with real services and prices.

Start free