Book an appointment
POST/appointments
Book an appointment with a contact on a calendar. The end time is computed from
duration_minutes (defaulting to the calendar's default slot duration). Write access
requires any contact or company write scope (contact.write | company.write, or their
.all variants) — no dedicated scope exists.
Request
Responses
- 201
- 401
- 403
- 409
- 422
The booked appointment (plus followup_task when one was requested)
Missing or invalid token
Token lacks the required scope, or the user's role/permissions deny this action
The request conflicts with the current state (e.g. the requested slot is not available)
Request failed schema validation