Update booking configuration

Duration, buffers, and weekly time boundaries use 30-minute increments. Provider connection IDs must belong to the selected store. Google Meet requires a same-store Google Calendar connection.

Authorization

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Path Parameters

product*string

The booking product ID or slug.

variant*integer

The variant path parameter.

Header Parameters

X-STORE?string

Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

mode?string

Value in"native"

conflict_scope?string

Value in"product" | "variant"

timezone?string

duration_minutes?integer

Multiple Of30

Range30 <= value

capacity_per_slot?integer

Range1 <= value <= 1000

min_notice_minutes?integer

Range0 <= value <= 525600

max_advance_days?integer

Range1 <= value <= 730

buffer_before_minutes?integer

Multiple Of30

Range0 <= value <= 1440

buffer_after_minutes?integer

Multiple Of30

Range0 <= value <= 1440

availability?array<>

Items7 <= items <= 7

provider_connection_ids?array<integer>

video_provider?string

Value in"none" | "google_meet" | "zoom"

video_provider_connection_id?integer|null

reminders_enabled?boolean

reminder_offset_value?integer

Range1 <= value <= 10080

reminder_offset_unit?string

Value in"minutes" | "hours" | "days" | "weeks"

meta?|null

Response Body

`application/json`

curl -X PATCH "https://sell.app/api/v2/products/41/variants/73/booking" \  -H "X-STORE: launch-lab" \  -H "Content-Type: application/json" \  -d '{    "timezone": "Europe/London",    "duration_minutes": 60,    "capacity_per_slot": 1,    "min_notice_minutes": 1440,    "max_advance_days": 60  }'

{
  "data": {
    "product_id": 41,
    "product_variant_id": 73,
    "mode": "native",
    "conflict_scope": "variant",
    "timezone": "Europe/London",
    "duration_minutes": 60,
    "capacity_per_slot": 1,
    "min_notice_minutes": 1440,
    "max_advance_days": 60,
    "buffer_before_minutes": 0,
    "buffer_after_minutes": 0,
    "availability": [
      {
        "day": 1,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 2,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 3,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 4,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 5,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 6,
        "enabled": false,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 7,
        "enabled": false,
        "start": "09:00",
        "end": "17:00"
      }
    ],
    "provider_connection_ids": [],
    "video_provider": "none",
    "video_provider_connection_id": null,
    "reminders_enabled": false,
    "reminder_offset_value": 1,
    "reminder_offset_unit": "hours",
    "meta": null
  }
}

{
  "type": "invalid_request_error",
  "code": "bad_request",
  "message": "The request could not be understood.",
  "status": 400,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#bad-request"
}

{
  "type": "authentication_error",
  "code": "unauthenticated",
  "message": "Unauthenticated.",
  "status": 401,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#unauthenticated"
}

{
  "type": "authorization_error",
  "code": "forbidden",
  "message": "This action is unauthorized.",
  "status": 403,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#forbidden"
}

{
  "type": "not_found_error",
  "code": "resource_not_found",
  "message": "Not Found.",
  "status": 404,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#resource-not-found"
}

{
  "type": "validation_error",
  "code": "validation_failed",
  "message": "The selected product variant id is invalid.",
  "status": 422,
  "param": "product_variant_id",
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#validation-failed",
  "errors": {
    "product_variant_id": [
      "The selected product variant id is invalid."
    ]
  }
}

{
  "type": "rate_limit_error",
  "code": "rate_limit_exceeded",
  "message": "Too Many Attempts.",
  "status": 429,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#rate-limit-exceeded"
}

{
  "type": "api_error",
  "code": "api_error",
  "message": "Server Error",
  "status": 500,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#api-error"
}

Authorization

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Path Parameters

product*string

The booking product ID or slug.

variant*integer

The variant path parameter.

Header Parameters

X-STORE?string

Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

mode?string

Value in"native"

conflict_scope?string

Value in"product" | "variant"

timezone?string

duration_minutes?integer

Multiple Of30

Range30 <= value

capacity_per_slot?integer

Range1 <= value <= 1000

min_notice_minutes?integer

Range0 <= value <= 525600

max_advance_days?integer

Range1 <= value <= 730

buffer_before_minutes?integer

Multiple Of30

Range0 <= value <= 1440

buffer_after_minutes?integer

Multiple Of30

Range0 <= value <= 1440

availability?array<>

Items7 <= items <= 7

provider_connection_ids?array<integer>

video_provider?string

Value in"none" | "google_meet" | "zoom"

video_provider_connection_id?integer|null

reminders_enabled?boolean

reminder_offset_value?integer

Range1 <= value <= 10080

reminder_offset_unit?string

Value in"minutes" | "hours" | "days" | "weeks"

meta?|null

Response Body

`application/json`

curl -X PUT "https://sell.app/api/v2/products/41/variants/73/booking" \  -H "X-STORE: launch-lab" \  -H "Content-Type: application/json" \  -d '{    "timezone": "Europe/London",    "duration_minutes": 60,    "capacity_per_slot": 1,    "min_notice_minutes": 1440,    "max_advance_days": 60  }'

{
  "data": {
    "product_id": 41,
    "product_variant_id": 73,
    "mode": "native",
    "conflict_scope": "variant",
    "timezone": "Europe/London",
    "duration_minutes": 60,
    "capacity_per_slot": 1,
    "min_notice_minutes": 1440,
    "max_advance_days": 60,
    "buffer_before_minutes": 0,
    "buffer_after_minutes": 0,
    "availability": [
      {
        "day": 1,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 2,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 3,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 4,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 5,
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 6,
        "enabled": false,
        "start": "09:00",
        "end": "17:00"
      },
      {
        "day": 7,
        "enabled": false,
        "start": "09:00",
        "end": "17:00"
      }
    ],
    "provider_connection_ids": [],
    "video_provider": "none",
    "video_provider_connection_id": null,
    "reminders_enabled": false,
    "reminder_offset_value": 1,
    "reminder_offset_unit": "hours",
    "meta": null
  }
}

{
  "type": "invalid_request_error",
  "code": "bad_request",
  "message": "The request could not be understood.",
  "status": 400,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#bad-request"
}

{
  "type": "authentication_error",
  "code": "unauthenticated",
  "message": "Unauthenticated.",
  "status": 401,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#unauthenticated"
}

{
  "type": "authorization_error",
  "code": "forbidden",
  "message": "This action is unauthorized.",
  "status": 403,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#forbidden"
}

{
  "type": "not_found_error",
  "code": "resource_not_found",
  "message": "Not Found.",
  "status": 404,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#resource-not-found"
}

{
  "type": "validation_error",
  "code": "validation_failed",
  "message": "The selected product variant id is invalid.",
  "status": 422,
  "param": "product_variant_id",
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#validation-failed",
  "errors": {
    "product_variant_id": [
      "The selected product variant id is invalid."
    ]
  }
}

{
  "type": "rate_limit_error",
  "code": "rate_limit_exceeded",
  "message": "Too Many Attempts.",
  "status": 429,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#rate-limit-exceeded"
}

{
  "type": "api_error",
  "code": "api_error",
  "message": "Server Error",
  "status": 500,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#api-error"
}

Update booking configuration

200application/json

400application/json

401application/json

403application/json

404application/json

422application/json

429application/json

500application/json

200application/json

400application/json

401application/json

403application/json

404application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`