Create a booking hold

Create a temporary hold for a booking slot before checkout. Send the hold ID with the checkout item so SellApp can confirm the reserved appointment after payment.

Authorization

bearerAuth

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Path Parameters

product*integer

The product path parameter.

variant*integer

The variant path parameter.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

slot_start_at*string

Formatdate-time

quantity?integer

Range1 <= value

customer_key?string|null

meta?|null

Response Body

`application/json`

curl -X POST "https://sell.app/api/v2/products/0/variants/0/booking/holds" \  -H "Content-Type: application/json" \  -d '{    "slot_start_at": "2026-06-22T14:00:00+00:00",    "quantity": 1,    "customer_key": "visitor-session-123",    "meta": {      "customer_timezone": "America/New_York"    }  }'

{
  "data": {
    "id": "018f61d6-1c46-7b42-8a94-522bc6b5c53f",
    "slot_start_at": "2026-06-22T14:00:00+00:00",
    "slot_end_at": "2026-06-22T14:30:00+00:00",
    "quantity": 1,
    "expires_at": "2026-06-22T13:45:00+00:00"
  }
}