Acuity Scheduling
Category: EHR & Practice Mgmt
Node id: acuity-scheduling
Standards: GDPR, HIPAA-eligible
Connects to Acuity Scheduling (Squarespace) REST API v1 for appointments, clients, and availability. Tier 1 — open public API, self-service signup.
What it does
- List, get, create, and cancel appointments
- List clients and appointment types
- Query slot availability
- OAuth2 Bearer and HTTP Basic authentication
Use cases
- Sync practice scheduling data into FHIR Appointment resources
- Trigger downstream pipelines when an Acuity appointment is created
- Reconcile no-show rates against EHR encounters
Runtime
- Performance tier:
fast
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
appointment_id | text | No | Appointment ID for get/cancel |
appointment | json | No | Appointment object for create |
query | json | No | Optional query string parameters |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | Parsed JSON response payload from the vendor API |
metadata | json | No | Operation, HTTP status code, and content length |
success | boolean | No | True if HTTP 2xx |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Base URL | base_url | string | No | https://acuityscheduling.com/api/v1 | Acuity API base URL | |
| Operation | operation | enum | Yes | list_appointments | list_appointments, get_appointment, create_appointment, cancel_appointment, list_clients, list_appointment_types, list_availability |
Auth
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Auth Type | auth_type | enum | No | basic | basic, oauth2 | |
| User ID | user_id | string | No | Acuity User ID (basic auth) | ||
| API Key | api_key | secret | No | Acuity API Key (basic auth) | ||
| OAuth2 Access Token | access_token | secret | No | OAuth2 Bearer token |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Min Date | min_date | string | No | Filter appointments from this date (YYYY-MM-DD) | ||
| Max Date | max_date | string | No | Filter appointments up to this date |
Errors
| Code | Description |
|---|---|
ACUITY_AUTH_FAILED | Authentication credentials missing or rejected |
ACUITY_REQUEST_FAILED | HTTP request to Acuity failed |
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
Something unclear? Send documentation feedback by email.