API Documentation

Build on BookingFlow

Connect your POS system, build custom integrations, or sync bookings with third-party tools using our RESTful API.

Request API Access Start Free

API access available on Business+ plans.

What you can build

Full access to your bookings, rooms, schedules, and customer data.

RESTful API

Standard HTTP methods (GET, POST, PUT, DELETE). JSON request and response bodies. Predictable resource-oriented URLs.

Secure authentication

API keys for server-to-server communication. Scoped permissions per key. Rotate keys without downtime.

Real-time updates

Changes to bookings, schedules, and rooms sync instantly. No polling required. Webhooks notify your system when events happen.

Webhook support

Get notified when bookings are created, updated, or canceled. Build automated workflows without constant API calls.

Example Request

curl https://bookingflowai.com/api/v1/catalog?orgId=YOUR_ORG_ID \
  -H "Content-Type: application/json"

Full API documentation will be available to Business+ customers. Contact us for early access.

Key API Endpoints

Full CRUD operations on all core resources.

Bookings

GET

/v1/bookings

List all bookings with filters (date, room, status)

GET

/v1/bookings/:id

Get a single booking by ID

POST

/v1/bookings

Create a new booking

PUT

/v1/bookings/:id

Update a booking (reschedule, modify guests)

DELETE

/v1/bookings/:id

Cancel a booking and process refund

Rooms

GET

/v1/rooms

List all rooms/experiences

GET

/v1/rooms/:id

Get room details, pricing, and availability

POST

/v1/rooms

Create a new room or experience

PUT

/v1/rooms/:id

Update room details or pricing

Schedules

GET

/v1/schedules

Get availability for a date range

POST

/v1/schedules/block

Block out dates for maintenance or events

Customers

GET

/v1/customers

List all customers

GET

/v1/customers/:id

Get customer profile and booking history

Authentication

All API requests require authentication via API keys. Generate keys from your dashboard (Business+ plan required).

Include your API key in the header

Authorization: Bearer YOUR_API_KEY

API keys are scoped to your organization. They cannot access other customers' data.
You can create multiple keys with different permissions (read-only, read-write).
Rotate keys anytime without downtime. Old keys continue working until revoked.

Webhooks

Get real-time notifications when events happen in your account. No polling required.

booking.created

Fired when a customer completes a new booking.

booking.updated

Fired when a booking is rescheduled or modified.

booking.canceled

Fired when a booking is canceled and refunded.

payment.succeeded

Fired when payment is successfully processed via Stripe.

Webhooks deliver a JSON payload to your endpoint via HTTP POST. We retry failed deliveries with exponential backoff.

API Documentation

We're finalizing comprehensive API docs with code examples, SDKs, and interactive testing tools.

Need API access now? Contact us and we'll give you early access with personalized onboarding.

Request API Access