Bookings

Monitor new bookings and automatically update booking statuses through Zapier workflows.

List bookings

get

Get a list of your bookings, sorted by most recently updated first.

Common uses:

• Trigger a Slack notification when a new booking is created

• Send booking details to a Google Sheet

• Sync bookings to your CRM

Use the status filter to get only bookings with a specific status (like PENDING or APPROVED). Use updatedSince to get only bookings created or modified after a certain date.

Note: Include page=1 in your requests for proper pagination.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Your FlowBookings API key. Generate one from Dashboard → Settings → Integrations → API Key. Include this header in every request.

Query parameters

pageinteger · min: 1Optional

Page number (starts at 1).

Default: 1Example: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page (1-100). Default is 25.

Default: 25Example: 25

updatedSincestring · date-timeOptional

Only return items created or updated after this date/time (ISO 8601 format).

Example: 2024-03-01T00:00:00.000Z

statusstring · enumOptional

The current status of a booking.

Status	What it means
PENDING	Customer has booked but awaiting your approval
APPROVED	Booking is confirmed
CANCELED	Booking was canceled by you or the customer
REJECTED	You declined the booking request
NO_SHOW	Customer didn't show up for the appointment
COMPLETED	Service was successfully delivered

Note: Once a booking is canceled, rejected, or completed, it cannot be changed to another status.

Example: APPROVEDPossible values:

Responses

200

Bookings retrieved successfully.

application/json

List of bookings with pagination info.

400

Invalid request parameters.

application/json

401

API key is missing or invalid.

application/json

500

Something went wrong on our end. Please try again.

application/json

get

/api/zapier/bookings

HTTPcURLJavaScriptPython

GET /api/zapier/bookings HTTP/1.1
Host: api.flowbookings.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "_id": "64b2e3c4d5f6a7b8c9d0e1f2",
      "id": "64b2e3c4d5f6a7b8c9d0e1f2",
      "startDate": "2024-03-15T10:00:00.000Z",
      "endDate": "2024-03-15T11:00:00.000Z",
      "status": "APPROVED",
      "service": {
        "_id": "64a1f2b3c4d5e6f7a8b9c0d1",
        "name": "60-Minute Strategy Session"
      },
      "customer": {
        "_id": "64a1f2b3c4d5e6f7a8b9c0d2",
        "firstName": "Jane",
        "lastName": "Smith",
        "email": "[email protected]"
      },
      "price": 150,
      "bookedCapacity": 1,
      "additionalData": null,
      "internalNote": null,
      "createdAt": "2024-03-10T14:32:00.000Z",
      "updatedAt": "2024-03-12T09:15:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "hasMore": false
  }
}

Get a booking by ID

get

Get details for a specific booking.

Common use: Look up booking information by ID to display details or check status.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Your FlowBookings API key. Generate one from Dashboard → Settings → Integrations → API Key. Include this header in every request.

Path parameters

bookingIdstringRequired

The booking ID.

Example: 64b2e3c4d5f6a7b8c9d0e1f2

Responses

200

Booking retrieved successfully.

application/json

401

API key is missing or invalid.

application/json

404

The requested item was not found.

application/json

500

Something went wrong on our end. Please try again.

application/json

get

/api/zapier/bookings/{bookingId}

HTTPcURLJavaScriptPython

GET /api/zapier/bookings/{bookingId} HTTP/1.1
Host: api.flowbookings.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "booking": {
    "_id": "64b2e3c4d5f6a7b8c9d0e1f2",
    "id": "64b2e3c4d5f6a7b8c9d0e1f2",
    "startDate": "2024-03-15T10:00:00.000Z",
    "endDate": "2024-03-15T11:00:00.000Z",
    "status": "APPROVED",
    "service": {
      "_id": "64a1f2b3c4d5e6f7a8b9c0d1",
      "name": "60-Minute Strategy Session"
    },
    "customer": {
      "_id": "64a1f2b3c4d5e6f7a8b9c0d2",
      "firstName": "Jane",
      "lastName": "Smith",
      "email": "[email protected]"
    },
    "price": 150,
    "bookedCapacity": 1,
    "additionalData": null,
    "internalNote": "VIP client",
    "createdAt": "2024-03-10T14:32:00.000Z",
    "updatedAt": "2024-03-12T09:15:00.000Z"
  }
}

Update booking status

put

Change a booking's status (approve, cancel, mark complete, etc.).

Common uses:

• Automatically approve bookings when payment is received in Stripe

• Cancel bookings when a refund is issued

• Mark bookings complete when service is delivered

• Set no-show status when customer doesn't attend

Important: You cannot change the status of bookings that are already canceled, rejected, or completed.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Your FlowBookings API key. Generate one from Dashboard → Settings → Integrations → API Key. Include this header in every request.

Path parameters

bookingIdstringRequired

The booking ID.

Example: 64b2e3c4d5f6a7b8c9d0e1f2

Body

application/json

statusstring · enumRequired

The new status for the booking. Case-insensitive (you can use 'approved' or 'APPROVED').

Note: You cannot change the status of bookings that are already canceled, rejected, or completed.

Example: APPROVEDPossible values:

Responses

200

Status updated successfully. Returns the full updated booking.

application/json

400

Invalid status value or booking cannot be updated.

application/json

401

API key is missing or invalid.

application/json

404

The requested item was not found.

application/json

500

Something went wrong on our end. Please try again.

application/json

put

/api/zapier/bookings/{bookingId}

HTTPcURLJavaScriptPython

PUT /api/zapier/bookings/{bookingId} HTTP/1.1
Host: api.flowbookings.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "status": "APPROVED"
}

Approve a pending bookingCancel a bookingMark customer as no-showMark service as delivered

{
  "booking": {
    "_id": "64b2e3c4d5f6a7b8c9d0e1f2",
    "id": "64b2e3c4d5f6a7b8c9d0e1f2",
    "startDate": "2024-03-15T10:00:00.000Z",
    "endDate": "2024-03-15T11:00:00.000Z",
    "status": "APPROVED",
    "service": {
      "_id": "64a1f2b3c4d5e6f7a8b9c0d1",
      "name": "60-Minute Strategy Session"
    },
    "customer": {
      "_id": "64a1f2b3c4d5e6f7a8b9c0d2",
      "firstName": "Jane",
      "lastName": "Smith",
      "email": "[email protected]"
    },
    "price": 150,
    "bookedCapacity": 1,
    "createdAt": "2024-03-10T14:32:00.000Z",
    "updatedAt": "2024-03-15T08:00:00.000Z"
  }
}