Acuity Scheduling API
Provides REST API access to Acuity Scheduling for automating appointment booking, availability checking, client management, and appointment type listing — enabling agents to book, reschedule, and cancel appointments on behalf of users.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
OAuth2 with scopes provides reasonable access control. API key auth (User ID + key pair) is a simpler option that grants full account access. No IP allowlisting documented.
⚡ Reliability
Best When
You are automating client-facing appointment booking workflows where Acuity is already the scheduling backend.
Avoid When
You need a general-purpose calendar API — use Google Calendar or Microsoft Graph instead. Avoid if Squarespace acquisition impacts are a concern for long-term API roadmap stability.
Use Cases
- • Booking appointments on behalf of a user after checking real-time availability slots via the /availability/times endpoint
- • Canceling or rescheduling appointments in response to user intent detected in a conversation agent
- • Listing available appointment types and their durations to present scheduling options to an agent's end user
- • Creating new client records and associating them with booked appointments in a CRM-integrated workflow
- • Polling appointment status and sending reminders or confirmations by reading upcoming appointment data
Not For
- • Complex calendar management outside appointment scheduling — Acuity is purpose-built for client-facing booking, not general calendar ops
- • High-frequency polling at sub-minute intervals — Acuity rate limits and architecture are not designed for real-time event streaming
- • Organizations needing enterprise SLAs or advanced compliance (HIPAA BAA not available on all tiers)
Interface
Authentication
OAuth2 for third-party integrations acting on behalf of Acuity account owners. API key (User ID + API Key) available for direct account access. OAuth scopes include read/write for appointments and availability.
Pricing
Acuity is a paid SaaS product. No free tier for API access. 7-day free trial available. Squarespace acquired Acuity in 2019 — pricing may align with Squarespace subscription bundles.
Agent Metadata
Known Gotchas
- ⚠ POST /appointments is not idempotent — a network timeout followed by retry will create a duplicate booking; agents must deduplicate by querying existing appointments first
- ⚠ Availability endpoint returns slots in the account owner's configured timezone, not UTC — agents must handle timezone conversion or misaligned slots will be booked
- ⚠ OAuth2 access tokens expire and require refresh — agents must implement token refresh logic or appointments will silently fail after token expiry
- ⚠ Squarespace acquisition has created uncertainty in API roadmap — some API features are underdocumented and future deprecations are not announced with sufficient lead time
- ⚠ Webhook delivery is not guaranteed and has no built-in retry mechanism — agents relying on webhooks for appointment status must implement reconciliation polling
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.