Booking API

The booking API for your product

GrowFlow Booking exposes a REST API at /api/v1 to integrate availability and bookings directly into your product. Authenticate with an API key (X-API-Key: bk_live_...) or a JWT, use the official Python and Node.js SDKs, and work with tenants, availability, bookings, calendars and credits. Webhooks keep you updated on events in real time.

  • REST API at /api/v1
  • Auth with an API key (bk_live_...) or JWT Bearer
  • Official Python and Node.js SDKs
  • Endpoints for availability, bookings and calendars
  • Webhooks for booking events
  • Quota and credits system for external integrations

A complete REST API

The GrowFlow Booking API is served at /api/v1 and covers the full booking flow: read tenants, query availability by dates and slots, create simple bookings or experiences, and manage calendars and quotas. It's the same API that powers the widget and the dashboard.

Authentication: API key or JWT

You can authenticate in two ways: with an API key sent in the X-API-Key header (format bk_live_...), meant for server-to-server integrations and SDKs, or with a JWT Bearer token for authenticated flows. Pick whichever fits your use case.

Official Python and Node.js SDKs

You don't have to build the client from scratch: use the official SDKs growflow-booking-client for Python and @growflow/booking-client for Node.js. They expose typed methods to read available slots and create bookings, so you integrate Booking in a few lines.

Webhooks and a credits system

The API includes webhooks to receive booking events in real time and a quota and credits system built for external integrations: assign credits to a customer and deduct them on each booking, useful when Booking is the engine behind another product.

Widget and chat on the same engine

If you'd rather not start from the API, the embeddable widget gives you a ready-made UI on the same backend: see the booking widget. And for a conversational experience, chat booking runs on these same APIs. All the technical details are on the developer page.

Learn more: the developer page · the booking widget

Frequently asked questions

Where is the booking API?
The REST API is served at /api/v1 and covers tenants, availability (dates and slots), simple bookings and experiences, calendars and quotas. It's the same API that powers the widget and the dashboard.
How does authentication work?
Two ways: an API key in the X-API-Key header (format bk_live_...), ideal for server-to-server integrations and SDKs, or a JWT Bearer token. Pick whichever fits your use case.
Are there official SDKs?
Yes: growflow-booking-client for Python and @growflow/booking-client for Node.js. They expose typed methods to read available slots and create bookings without hand-building the client.
Are webhooks available?
Yes. The API includes webhooks to receive booking events in real time, so you can keep your own system in sync with what happens on Booking.
What is the credits system?
It's a quota and credits system for external integrations: assign credits to a customer and deduct them on each booking. It's useful when Booking acts as the booking engine behind another product.

Integrate bookings via API

Create your account, generate an API key and start integrating availability and bookings with the official SDKs.

Create your free account