Use when working with Acuity Scheduling (now Squarespace Scheduling) API — appointment booking, availability checks, calendar management, client management, blocks, and webhooks. Also use when setting up API credentials, implementing OAuth2 multi-account flows, or handling webhook signatures.
| Model | Source | Category |
|---|
| inherit | core | Other |
Full Reference
Acuity Scheduling (rebranded as Squarespace Scheduling) provides a REST API (v1.1) for programmatic appointment management, availability querying, and scheduling automation. API access requires the Premium plan ($49/mo annual) or higher — Starter and Standard plans have no API access.
| Item | Value |
|---|
| API Version | v1.1 (current), v1.0 (legacy) |
| Base URL | https://acuityscheduling.com/api/v1/ |
| Auth (single account) | HTTP Basic Auth — User ID + API Key |
| Auth (multi-account) | OAuth2 — scope=api-v1 |
| Rate Limit | 10 req/s, 20 concurrent connections |
| Rate Limit Error | HTTP 429 |
| Webhook Limit | 25 per account |
| Node SDK | npm install acuityscheduling |
| PHP SDK | composer require acuityscheduling/acuityscheduling |
| Credentials Location | Account → Integrations → API section |
| OAuth2 App Registration | https://acuityscheduling.com/oauth2/register |
| Env Vars | ACUITY_USER_ID, ACUITY_API_KEY, ACUITY_CLIENT_ID, ACUITY_CLIENT_SECRET |
| I want to… | Reference File |
|---|
| Set up credentials, authenticate with Basic Auth or OAuth2, install the SDK, or handle rate limits | setup.md |
| Check available dates or times, query class sessions, or handle timezones | availability.md |
| Book, update, cancel, or reschedule appointments — including intake forms and full booking flow | appointments.md |
| Manage clients, create calendar blocks, list calendars, or get appointment types | clients.md |
| Handle webhook events, verify signatures, manage retries, or create/delete webhooks via API | webhooks.md |