Booksy Public API

The Booksy Public API is a partner-facing REST API for managing Booksy businesses and their booking data. It is organized around resource-oriented URLs, returns JSON, uses standard HTTP verbs and status codes, and is versioned with an Accept header carrying "application/json; version=0.3". Partners authenticate with an RSA key pair (separate keys for sandbox and production), signing a short-lived RS256 JWT assertion that is exchanged at /token/ for a 5-minute access token and a 3-day refresh token. The documented surface covers 96 endpoints across business, business category, business amenities, business schedule, traveling-to-customer, region reverse geocoding, users, resources, resource photos, resource schedules, resource time off, services, service variants, service photos, service categories, consent forms, customers, appointments, appointment consents, appointment reviews and review statistics, plus an appointment webhook delivered to the partner.

API entry from apis.yml

apis.yml Raw ↑
aid: booksy:booksy-public-api
name: Booksy Public API
description: The Booksy Public API is a partner-facing REST API for managing Booksy businesses and their
  booking data. It is organized around resource-oriented URLs, returns JSON, uses standard HTTP verbs
  and status codes, and is versioned with an Accept header carrying "application/json; version=0.3". Partners
  authenticate with an RSA key pair (separate keys for sandbox and production), signing a short-lived
  RS256 JWT assertion that is exchanged at /token/ for a 5-minute access token and a 3-day refresh token.
  The documented surface covers 96 endpoints across business, business category, business amenities, business
  schedule, traveling-to-customer, region reverse geocoding, users, resources, resource photos, resource
  schedules, resource time off, services, service variants, service photos, service categories, consent
  forms, customers, appointments, appointment consents, appointment reviews and review statistics, plus
  an appointment webhook delivered to the partner.
humanURL: https://docs.booksy.com/
baseURL: https://us.booksy.com/public-api/us/
tags:
- Appointments
- Booking
- Scheduling
- Customers
- Reviews
- Webhooks
properties:
- type: Documentation
  url: https://docs.booksy.com/
- type: APIReference
  url: https://docs.booksy.com/v01.html
- type: Authentication
  url: authentication/booksy-authentication.yml
- type: Conventions
  url: conventions/booksy-conventions.yml
- type: ErrorCatalog
  url: errors/booksy-error-codes.yml
- type: RateLimits
  url: rate-limits/booksy-rate-limits.yml
- type: Webhooks
  url: asyncapi/booksy-appointment-webhooks.yml
- type: DataModel
  url: data-model/booksy-data-model.yml
- type: Sandbox
  url: sandbox/booksy-sandbox.yml
- type: Lifecycle
  url: lifecycle/booksy-lifecycle.yml