Cancel appointment.

DELETE/api/v1/calendars/appointments/{id}

Browse API endpoints

Calendar and booking / CRM REST API

Scope: appointments:write

Query parameters:

reason - Optional cancellation reason (e.g., ?reason=Customer%20requested)

Response: 200 OK

Code example

{
  "data": {
    "id": "appt_abc123",
    "cancelled": true
  }
}

Loading endpoint details...

Build a request

Request example

Documented defaults and example values are ready. Change only the parameters you need.

Connection

Your CRM deployment URL

Replace the Bearer API key placeholder in the copied server-side code. No API key is entered or sent here.

Sub-account ID Agency keys onlyAgency-scoped keys require the X-Sub-Account-Id header.

Path parameters

id Required

Query parameters

reason - Optional cancellation reason (e.g., ?reason=Customer%20requested)

cURL

curl --request DELETE \
  --url 'https://your-crm.example.com/api/v1/calendars/appointments/ID_HERE' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

This shows a static response from the documentation. It does not send a request to your CRM or use an API key.