# Acuity Scheduling API (slim)

> Acuity Scheduling is Squarespace's appointment booking product. Its REST API reads availability, creates, reschedules and cancels appointments, manages clients and blocked time, and sends webhooks, with Basic authentication or OAuth2.

- Full: https://www.anchorterminal.com/tools/acuity-scheduling.md (~7,600 tokens) · this version ~1,730 tokens · JSON https://www.anchorterminal.com/tools/acuity-scheduling.json · canonical https://www.anchorterminal.com/tools/acuity-scheduling
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-08

**E · 42.4/100 · rank #678 of 722 · #8 in Calendars & scheduling · not agent-ready · confidence medium**


Assessment: The API covers the full booking cycle, with availability checks, named error codes and signed webhooks retried for 24 hours. API access is sold only on the Premium plan at $61 a month, the single OAuth scope grants the whole account, and no changelog, idempotency key or audit log was found in the reviewed documentation.

## Facts

- Kind: HTTP API · vendor: Squarespace · category: Calendars & scheduling · legal entity: Squarespace, Inc. · provenance 74/100
- Endpoint: `https://acuityscheduling.com/api/v1` (HTTP)
- Auth: OAuth or key · pricing: Paid · x402: no · licence: Proprietary service under Squarespace's Developer Terms. The Node.js and PHP SDKs are MIT
- Probe metrics: not measured yet (probes haven't run)
- Surface graded: The public REST API at https://acuityscheduling.com/api/v1. No official MCP server for the product was found in the developer docs
- Endpoints: 36 reference pages covering appointments (list, get, create, update, cancel, reschedule, payments), appointment types and add-ons, availability (dates, times, classes, check-times), blocks, calendars, clients, forms, labels, certificates, orders, products, `/me` and `/meta`, plus `/webhooks`
- Credentials: HTTP Basic with User ID and one account API key, or OAuth2 authorisation code grant with the single scope `api-v1` and a Bearer token
- Plan needed: Premium, $61 a month or $49 a month billed yearly, per the pricing page. 7-day trial without a card
- Rate limits: 10 requests a second and 20 concurrent connections per IP. 429 with a JSON body, no `Retry-After` documented
- Listing controls: `GET /appointments` takes `max` (default 100), `minDate`, `maxDate`, `calendarID`, `appointmentTypeID`, client name, email and phone filters, `excludeForms` and `direction`. No cursor or offset is documented
- Errors: JSON with `status_code`, `error` and `message`. Booking has named codes such as `required_email`, `invalid_timezone` and `invalid_appointment_type`
- Dates and time zones: `datetime` is parsed by PHP's strtotime in the business or calendar time zone. Time zones are IANA identifiers
- Webhooks: Five events, form-encoded POST with IDs only, `x-acuity-signature` HMAC-SHA256, nine retries over 24 hours, disabled after five days of failures, 25 subscriptions an account. `/meta` lists the sending IP ranges
- SDKs: Node.js `acuityscheduling` 0.1.9 on npm and PHP `acuityscheduling/acuityscheduling` on Packagist, both MIT, last tagged July 2019
- Status: status.acuityscheduling.com on Statuspage, one component for the whole product, with an incident history back past October 2025
- Compliance: HIPAA business associate agreement on Premium. Squarespace's measures page states regular penetration testing. No SOC 2 or ISO 27001 report is named
- Prices: Premium (the plan with API access) $61 per month (plan)

- Scores: Reliability 58, Performance pending, Schema & documentation 56, Agent ergonomics 44, Security & auth 27, Payments & pricing 30, Task success pending, Maintenance & community 15, Transparency & trust 54 · total over the 7 assessed categories
- Why: Reliability, Graded as a hosted API. · Schema & documentation, Each reference page carries an OpenAPI 3.1 fragment for its own operation, generated by the docs platform from hand-written pages. · Agent ergonomics, `max` caps list size and `excludeForms` trims intake forms from appointments. · Security & auth, Basic authentication with one account API key, or OAuth2 with the single scope `api-v1`. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, No changelog or release notes found. · Transparency & trust, Closed service under Squarespace's Developer Terms of 16 December 2025, with MIT SDKs (15).
- Sources: 28, open questions: 9, both in the full twin
- Capabilities: calendar.read, calendar.availability, calendar.booking, calendar.webhooks
- JSON: https://www.anchorterminal.com/api/v1/tools/acuity-scheduling.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/acuity-scheduling.svg` or a link to https://www.anchorterminal.com/tools/acuity-scheduling from a page on acuityscheduling.com or one of its subdomains, or the README of github.com/AcuityScheduling/acuity-js, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Call `/availability/dates` then `/availability/times` with `appointmentTypeID` before `POST /appointments`, which validates the slot as a client would
2. Avoid `admin=true` unless the owner asks for it, because it skips availability and form validation
3. Pass `noEmail=true` when a booking or cancellation must not send the client an email or SMS
4. Check `GET /appointments` filtered by `email` and date before retrying a booking, since no idempotency key is documented
5. Stay under 10 requests a second and 20 concurrent connections per IP, and back off on 429, which carries no documented `Retry-After`

## Connect

```bash
npm install --save acuityscheduling
```

```bash
curl -u ACUITY_USER_ID:ACUITY_API_KEY "https://acuityscheduling.com/api/v1/appointments"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/acuity-scheduling

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Nylas Calendar and Scheduler API | BB | 71 | calendar.read, calendar.availability, calendar.booking, calendar.webhooks | https://www.anchorterminal.com/tools/nylas-calendar.min.md |
| Calendly API + MCP | B | 68.3 | calendar.read, calendar.availability, calendar.booking, calendar.webhooks | https://www.anchorterminal.com/tools/calendly.min.md |
| Cronofy API | B | 64.2 | calendar.read, calendar.availability, calendar.booking, calendar.webhooks | https://www.anchorterminal.com/tools/cronofy.min.md |
| Cal.com API v2 + MCP | C | 57.2 | calendar.read, calendar.availability, calendar.booking, calendar.webhooks | https://www.anchorterminal.com/tools/cal-com.min.md |
| Aurinko Calendar API | E | 45.6 | calendar.read, calendar.availability, calendar.booking, calendar.webhooks | https://www.anchorterminal.com/tools/aurinko-calendar.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)