Authenticate to the Booksy Public API and retrieve or create appointments for a business.
domain: docs.booksy.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Request Booksy Public API access and obtain separate RSA key pairs for sandbox and production environments.
Use JSON Web Token authentication: sign a request with your private key to obtain an access token (5-minute lifetime) and a refresh token (3-day lifetime).
Call GET https://<country_code>.booksy.com/public-api/<country_code>/business/<business_id>/appointments/ with booked_from/booked_till and pagination parameters to list appointments.
Call the corresponding appointment endpoint to create a new appointment or time reservation for the business.
Refresh the access token before it expires (every ~5 minutes), and re-authenticate fully once the refresh token itself expires.
Known gotchas
Access tokens are extremely short-lived (5 minutes), so integrations must build token refresh into every request cycle rather than caching a token for the session.
Endpoints are region-scoped by country_code embedded in the URL path itself, not just as a parameter, so a business operating in multiple countries needs to target the correct regional path.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?