Overview
Acuity Scheduling (Squarespace Scheduling) is an appointment-booking platform. The Automize Acuity connector covers appointment lifecycle, availability lookups, appointment types, calendars, and client management.
- Regions: Acuity is a single global service – acuityscheduling.com.
- Plans: Emerging, Growing, Powerhouse – all expose the API. Some features (group classes, packages) need higher plans.
Setting up the connection
Auth type: HTTP Basic.
- Sign in to Acuity → Integrations → API.
- Copy User ID + API Key.
- In Automize, open Settings → Connectors → Acuity → Add connection. User ID as username, API Key as password.
Find your credentials at https://secure.acuityscheduling.com/app.php?view=api.
Rate limits
Acuity has unpublished but generous limits. Connector retries 429 with backoff.
Data model
Acuity primitives:
Account ─┬─ Calendars (your team's bookable resources)
├─ Appointment Types (e.g. '30min Consult', '60min Massage')
├─ Appointments (concrete bookings)
└─ ClientsAvailable operations
10 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Cancel Appointment | General | Cancel an appointment |
| Create Appointment | General | Book a new appointment |
| Get Appointment | General | Get appointment details |
| Get Availability Dates | General | Get available dates for a month |
| Get Availability Times | General | Get available times for a date |
| List Appointment Types | General | List available appointment types |
| List Appointments | General | List all appointments |
| List Calendars | General | List all calendars |
| List Clients | General | List all clients |
| Update Appointment | General | Update an appointment |
Operations
Cancel Appointment
Cancel an appointment
| Parameter | Required | Type | Description |
|---|---|---|---|
Appointment Id appointment_id | Yes | text |
Tips
- Cancels + emails the client (cancelReason optional, shown in email).
Create Appointment
Book a new appointment
| Parameter | Required | Type | Description |
|---|---|---|---|
Datetime datetime | Yes | text | |
Appointmenttypeid appointmentTypeID | Yes | text | |
Firstname firstName | Yes | text | |
Lastname lastName | Yes | text | |
Email email | Yes | text |
Tips
- datetime (ISO 8601), appointmentTypeID, firstName, lastName, email.
- fields[] for custom intake form answers.
Get Appointment
Get appointment details
| Parameter | Required | Type | Description |
|---|---|---|---|
Appointment Id appointment_id | Yes | text |
Tips
- Returns appointment + client + appointment type.
Get Availability Dates
Get available dates for a month
No input parameters.
Tips
- appointment_type_id + month (YYYY-MM). Returns available dates.
Get Availability Times
Get available times for a date
No input parameters.
Tips
- appointment_type_id + date (YYYY-MM-DD). Returns slot start times.
List Appointment Types
List available appointment types
No input parameters.
Tips
- Use Get Availability Dates / Times with appointment_type_id from here.
List Appointments
List all appointments
No input parameters.
Tips
- Filter by minDate, maxDate (YYYY-MM-DD), email, firstName, lastName.
List Calendars
List all calendars
No input parameters.
Tips
- Returns all bookable calendars (often one per team member).
List Clients
List all clients
No input parameters.
Tips
- Search by email, firstName, lastName, phone.
Update Appointment
Update an appointment
| Parameter | Required | Type | Description |
|---|---|---|---|
Datetime datetime | Yes | text | |
Firstname firstName | Yes | text | |
Lastname lastName | Yes | text | |
Email email | Yes | text | |
Appointment Id appointment_id | Yes | text |
Tips
- Reschedule by updating datetime. Acuity emails the client automatically.
FAQ
- Sandbox?
- No formal sandbox. Use a test Acuity account (free trial) for non-prod work.
- Custom intake fields?
- Pass fields:[{id: form_field_id, value: 'response'}] on Create Appointment. Field IDs come from your Acuity intake form configuration.
- Group classes – how?
- Group classes appear as appointmentTypeID with capacity. Use Get Class Times (not exposed here) for class-specific scheduling.