Manage appointments with customers. Create consultations, fittings, and pickup appointments.
/api/vendor/appointmentsReturns appointments, optionally filtered by date range.
Requires scope: appointments:read
curl -s "https://brutlers.com/api/vendor/appointments?from=2026-04-01&to=2026-04-30" \
-H "X-Api-Key: brut_your_api_key_here"/api/vendor/appointmentsCreates a new appointment for an existing customer.
Requires scope: appointments:write
| Field | Type | Description | |
|---|---|---|---|
| customerId | string | Required | Customer ID (CUID) |
| type | string | Required | Appointment type |
| date | string | Required | Date and time (ISO 8601) |
| duration | number | Optional | Duration in minutes (15–480, default: 60) |
| notes | string | Optional | Notes about the appointment |
| orderId | string | Optional | Linked order (optional) |
Appointment type
curl -X POST https://brutlers.com/api/vendor/appointments \
-H "X-Api-Key: brut_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"customerId": "clx1234567890abcdef",
"type": "CONSULTATION",
"date": "2026-04-15T10:00:00Z",
"duration": 60,
"notes": "Erstberatung Brautkleid"
}'Appointments go through the following statuses:
PROPOSED → CONFIRMED, PROPOSED → CANCELLED, CONFIRMED → COMPLETED, CONFIRMED → CANCELLED
/api/vendor/appointments/:idUpdates an appointment. Status transitions are validated.
Requires scope: appointments:write
/api/vendor/appointments/:idDeletes an appointment. Only possible with status PROPOSED or CANCELLED.
Requires scope: appointments:write