Create a booking

POST

https://prod.your-api-server.com/bookings

Last modified:2026-04-29 08:09:11

Creates a new reservation through the same pipeline the portal uses —
resource allocation, conflict checks, deposit policies, customer
linkage, and outbound confirmation messages all run as on the portal.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "businessLocationId": "84527a82-7de9-4552-9101-e217e0c1ba3a",
    "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
    "customerName": "string",
    "customerEmail": "string",
    "customerPhone": "string",
    "notes": "string",
    "optInEmail": true,
    "optInSms": true,
    "items": [
        {
            "reservableVariantId": "9690f75d-e491-408d-adc6-ca59c38a215c",
            "staffMemberId": "138ee295-38b9-456a-b430-39719940f4cd",
            "startsAt": "2019-08-24T14:15:22.123Z",
            "resourceSelections": [
                {
                    "resourceTypeId": "a59ee688-b5e5-4606-9891-f4a605edacd3",
                    "specificResourceId": "0c1fbbe8-4e41-4284-a7b4-093f14c005be"
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://prod.your-api-server.com/bookings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "businessLocationId": "84527a82-7de9-4552-9101-e217e0c1ba3a",
    "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
    "customerName": "string",
    "customerEmail": "string",
    "customerPhone": "string",
    "notes": "string",
    "optInEmail": true,
    "optInSms": true,
    "items": [
        {
            "reservableVariantId": "9690f75d-e491-408d-adc6-ca59c38a215c",
            "staffMemberId": "138ee295-38b9-456a-b430-39719940f4cd",
            "startsAt": "2019-08-24T14:15:22.123Z",
            "resourceSelections": [
                {
                    "resourceTypeId": "a59ee688-b5e5-4606-9891-f4a605edacd3",
                    "specificResourceId": "0c1fbbe8-4e41-4284-a7b4-093f14c005be"
                }
            ]
        }
    ]
}'

Responses

🟢201

application/json

Created

Body

Example

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "publicId": "string",
    "businessLocationId": "84527a82-7de9-4552-9101-e217e0c1ba3a",
    "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
    "customerName": "string",
    "customerEmail": "string",
    "customerPhone": "string",
    "status": "string",
    "totalCents": 0,
    "startsAt": "2019-08-24T14:15:22.123Z",
    "endsAt": "2019-08-24T14:15:22.123Z",
    "completedAt": "2019-08-24T14:15:22.123Z",
    "notes": "string",
    "createdAt": "2019-08-24T14:15:22.123Z",
    "items": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "reservableVariantId": "9690f75d-e491-408d-adc6-ca59c38a215c",
            "staffMemberId": "138ee295-38b9-456a-b430-39719940f4cd",
            "serviceName": "string",
            "startsAt": "2019-08-24T14:15:22.123Z",
            "endsAt": "2019-08-24T14:15:22.123Z",
            "priceCents": 0
        }
    ]
}

🟠400

🟠401

🟠409

🟠429

🔴500

Modified at 2026-04-29 08:09:11

List bookings

Get a booking