API Reference

The FlowBookings Zapier API allows you to connect your booking system with thousands of other apps. Use triggers to react when bookings are created or updated, and actions to manage your bookings automatically.

Quick Links

• Bookings - Retrieve and update booking information

• Services - Access your service catalogue

Authentication

Every API request must include your FlowBookings API key.

How to Get Your API Key

1. Log in to your FlowBookings account

2. Go to Dashboard → Integrations → API Key

3. Copy your API key (or generate a new one if needed)

How to Use Your API Key

Include your API key in the x-api-key header on every request:

curl https://api.flowbookings.io/api/zapier/bookings?page=1 \
  -H "x-api-key: your_api_key_here"

Security

• Keep it private: Never share your API key in public forums or code repositories

• Account access: Your API key only accesses your own bookings and services

• If compromised: Generate a new key immediately from your dashboard

Base URL

All API requests should be made to:

https://api.flowbookings.io

Response Format

All successful responses return data in JSON format with this structure:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 25,
    "hasMore": false
  }
}

Pagination

List endpoints return paginated results. Use these parameters to navigate through pages:

• page - Page number (starts at 1)

• limit - Items per page (1-100, default: 25)

• hasMore - Boolean indicating if more pages exist

Example:

# Get page 2 with 50 items per page
GET /api/zapier/bookings?page=2&limit=50

Filtering

Some endpoints support filtering to retrieve specific data:

• status - Filter bookings by status (PENDING, APPROVED, CANCELED, etc.)

• updatedSince - Get only items updated after a specific date

Example:

# Get only approved bookings updated since March 1st
GET /api/zapier/bookings?status=APPROVED&updatedSince=2024-03-01T00:00:00.000Z

Error Handling

When something goes wrong, the API returns an error response:

{
  "error": "validation_error",
  "messages": ["Invalid status. Use: APPROVED, PENDING, CANCELED, NO_SHOW, REJECTED, or COMPLETED"]
}

Common error codes:

• unauthorized - API key is missing or invalid

• validation_error - Request contains invalid data

• not_found - Requested item doesn't exist

• server_error - Something went wrong on our end

Support

Need help with the API? Contact us: https://www.flowbookings.io/contact