SellApp
API ReferenceBookings

Update an appointment

Reschedule or cancel a customer appointment.

Patch the appointment with a future slot_start_at to reschedule it. To cancel it, patch the dedicated status endpoint with status: "cancelled". Rescheduling rechecks availability and refuses stale or conflicting changes.

PATCH
/v2/bookings/{booking}

Authorization

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Path Parameters

booking*string

The appointment UUID or numeric ID.

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.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://sell.app/api/v2/bookings/018f61d6-1c46-7b42-8a94-522bc6b5c53f" \  -H "X-STORE: launch-lab" \  -H "Content-Type: application/json" \  -d '{    "slot_start_at": "2028-03-27T10:00:00+01:00",    "timezone": "Europe/London"  }'
{
  "data": {
    "id": "018f61d6-1c46-7b42-8a94-522bc6b5c53f",
    "product_id": 41,
    "product_variant_id": 73,
    "order_id": 501,
    "invoice_id": 901,
    "customer_id": 301,
    "customer_email": "isabel.torres@example.com",
    "slot_start_at": "2028-03-27T09:00:00.000Z",
    "slot_end_at": "2028-03-27T09:30:00.000Z",
    "timezone": "Europe/London",
    "quantity": 1,
    "status": "confirmed",
    "calendar_sync_status": "synced",
    "external_event_link": "https://calendar.google.com/calendar/event?eid=example",
    "video_join_url": "https://meet.google.com/abc-defg-hij",
    "confirmed_at": "2028-03-01T12:00:00Z",
    "cancelled_at": null,
    "created_at": "2028-03-01T11:59:00Z",
    "updated_at": "2028-03-01T12:01:00.000000Z",
    "product": {
      "id": 41,
      "title": "Canva deck intervention"
    },
    "variant": {
      "id": 73,
      "title": "Thirty slides or thirty minutes"
    }
  }
}
{
  "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"
}
PATCH
/v2/bookings/{booking}/status

Authorization

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Path Parameters

booking*string

The appointment UUID or numeric ID.

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.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://sell.app/api/v2/bookings/018f61d6-1c46-7b42-8a94-522bc6b5c53f/status" \  -H "X-STORE: launch-lab" \  -H "Content-Type: application/json" \  -d '{    "status": "cancelled"  }'
{
  "data": {
    "id": "018f61d6-1c46-7b42-8a94-522bc6b5c53f",
    "product_id": 41,
    "product_variant_id": 73,
    "order_id": 501,
    "invoice_id": 901,
    "customer_id": 301,
    "customer_email": "isabel.torres@example.com",
    "slot_start_at": "2028-03-26T09:00:00Z",
    "slot_end_at": "2028-03-26T09:30:00Z",
    "timezone": "Europe/London",
    "quantity": 1,
    "status": "cancelled",
    "calendar_sync_status": "cancelled",
    "external_event_link": null,
    "video_join_url": null,
    "confirmed_at": "2028-03-01T12:00:00Z",
    "cancelled_at": "2028-03-01T12:01:00.000000Z",
    "created_at": "2028-03-01T11:59:00Z",
    "updated_at": "2028-03-01T12:01:00.000000Z",
    "product": {
      "id": 41,
      "title": "Canva deck intervention"
    },
    "variant": {
      "id": 73,
      "title": "Thirty slides or thirty minutes"
    }
  }
}
{
  "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"
}

Retrieve an appointment

Retrieve one appointment by UUID or numeric ID.

Retrieve booking configuration

Read availability and appointment settings for a booking variant.