Create appointment
acuity_create_appointmentDestructive
CREATES a new appointment (books a client into a time slot). This MODIFIES the calendar and, unless suppressed, may send confirmation emails. Acuity REST: POST /appointments.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| admin | No | If true, book as admin — bypasses availability checks and required-form enforcement. Default false. | |
| Yes | Client email (required). | ||
| notes | No | Notes to attach to the appointment. | |
| phone | No | Client phone number. | |
| fields | No | Intake form field answers, each { id, value }. | |
| noEmail | No | If true, suppress client/owner confirmation emails. | |
| datetime | Yes | Start time in ISO 8601 with offset, e.g. '2026-08-15T14:00:00-0400' (required). | |
| lastName | Yes | Client last name (required). | |
| timezone | No | IANA timezone for the datetime, e.g. 'America/New_York'. | |
| firstName | Yes | Client first name (required). | |
| calendarID | No | Calendar id to book on (defaults to an available one). | |
| appointmentTypeID | Yes | Appointment type id to book (required). |