Acuity Scheduling API
REST API for Acuity Scheduling (owned by Squarespace) for automating appointment booking, availability checks, client management, and intake forms for service-based businesses.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Appointment scheduling (now Squarespace Scheduling). OAuth2 + basic auth. Client appointment data is PII. Payment info handled by integration — PCI scope depends on setup.
⚡ Reliability
Best When
Agents need to automate appointment booking for service businesses with staff scheduling, intake forms, and client-facing flows already on Acuity.
Avoid When
You need a developer-first scheduling platform with MCP support or self-hosting — Acuity is a closed SaaS product with limited API extensibility.
Use Cases
- • Booking appointments for service businesses (salons, coaches, clinics) via agent workflows
- • Checking real-time staff availability across appointment types
- • Syncing client records and intake form responses to external CRMs
- • Sending automated reminders and follow-ups triggered by appointment webhooks
- • Building white-label scheduling flows on top of Acuity's backend
Not For
- • Meeting scheduling between knowledge workers (use Cal.com or Calendly)
- • Enterprise resource and room booking
- • High-volume programmatic scheduling without human clients
Interface
Authentication
OAuth2 for third-party integrations (user grants access to their Acuity account). API key + User ID (HTTP Basic auth) for direct owner access. OAuth scopes cover appointments, clients, availability, and forms. No granular sub-scopes within categories.
Pricing
Acquired by Squarespace in 2019. All plans include API access. Pricing has increased since acquisition. Annual billing saves ~10%. No free tier after trial.
Agent Metadata
Known Gotchas
- ⚠ Rate limits are undocumented — aggressive polling for availability will trigger throttling without clear error
- ⚠ Appointment type IDs are numeric and environment-specific — must be fetched dynamically
- ⚠ OAuth app registration requires manual review from Acuity/Squarespace — can take days
- ⚠ Webhook payloads include limited fields — agents often need a follow-up GET to get full appointment details
- ⚠ No sandbox/test environment — all testing against production account with real calendar
- ⚠ Calendar IDs differ between owner and calendar-owner views — use correct scoping for multi-staff scenarios
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Acuity Scheduling API.
Scores are editorial opinions as of 2026-03-06.