Acuity Scheduling
Connect Acuity Scheduling to book and manage appointments, availability, clients, intake forms, coupons, and orders.
You paste two values from one Acuity screen: the numeric User ID and the matching API Key. PopMCP sends them together as HTTP Basic auth.
Paid plan required before this connector works
No one reviews you, but Acuity (Squarespace Scheduling) only exposes API credentials on the Premium plan - "Custom API and CSS for Developers" is listed as a Premium-tier feature on the Acuity pricing page.
- Typical wait
- None - credentials appear immediately once the account is on Premium
- Cost
- Per acuityscheduling.com/pricing: Premium is $49/month billed annually or $61/month billed monthly. Starter ($16 annual / $20 monthly) and Standard ($27 annual / $34 monthly) do not include the API.
- Blocked until approved
- Everything. On Starter or Standard the API credentials screen does not issue a User ID and API Key, so every request fails 401, and webhooks are unavailable too.
- Works meanwhile
- The 7-day free trial runs on the top tier, so you can pull real credentials and build the whole integration before paying; you can also read the docs and model the endpoints.
Where to apply: No form. Upgrade the account to Premium, then in Acuity go to Integrations > scroll to API > View Credentials (secure.acuityscheduling.com/app.php?action=settings&key=api). For multi-account apps, register an OAuth2 client at secure.acuityscheduling.com/oauth2/register while signed in to a paid account.
- Auth is HTTP Basic with the numeric User ID as username and the API Key as password - people paste the key alone and get a permanent 401.
- A downgrade to Standard silently revokes API access on an integration that was working.
- Acuity accounts created through Squarespace as Squarespace Scheduling map to different plan names; confirm the tier includes 'Custom API' before building.
- OAuth2 client registration at secure.acuityscheduling.com/oauth2/register is done from a signed-in Acuity account; since API access itself is Premium-gated, verify the account's tier before relying on an OAuth client for production.
- Setup time
- 3 min
- Auth
- API credentials
- API base URL
- https://acuityscheduling.com/api/v1
- Rate limits
- 10 requests per second and 20 concurrent connections per IP address. Going over returns HTTP 429.
Before you begin
- An Acuity Scheduling (formerly Squarespace Scheduling) account on any paid plan
- Owner or admin sign-in. Team-member logins without Business Settings access cannot open Integrations
- The credentials belong to the whole account, so the connection is locked to that one Acuity business
Get your credentials
Open Integrations under Business Settings
Sign in at secure.acuityscheduling.com. In the left sidebar scroll to the Business Settings group and click Integrations.
Integrations
Connect Acuity to the other tools your business runs on.
| Integration | Category | Status |
|---|---|---|
| Google CalendarTwo-way sync | Calendar Sync | Connected |
| StripeCard payments | Payment Processors | Connected |
| Zapier8,000+ apps | Analytics + Custom Integrations | Not set up |
| APIDirect REST access | Analytics + Custom Integrations | Available |
Acuity has no separate developer console. Everything API-related lives on this page.
Open Analytics + Custom Integrations and click view credentials
Click Analytics + Custom Integrations in the category menu, then scroll to the API block. Click view credentials, next to the Developer's Site button.
Analytics + Custom Integrations
| Integration | Status | |
|---|---|---|
| Google Analytics | Not set up | Set up |
| Google Tag Manager | Not set up | Set up |
| Webhooks | Available | Configure |
The API block sits at the bottom of this category.
Copy the User ID and API Key
Copy the numeric User ID and the API Key from the expanded panel. The User ID is the Basic-auth username and the API Key is the password.
API credentials
Use the User ID as the username and the API Key as the password.
- User ID
- 1234****
- API Key
- a1b2****9f3c
Both values appear together, so copy them in one visit.
Paste both values into PopMCP
Put the numeric value in User ID and the secret in API Key, then click connect.
Connect in PopMCP
Open your workspace, choose Acuity Scheduling in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| User IDtext | In Acuity go to Bizz Settings → Integrations → API and click "view credentials". Copy the numeric User ID. This is the account the MCP is locked to. |
| API Keysecret | Same screen (Integrations → API → view credentials): copy the API Key. It's sent as HTTP Basic auth and stored encrypted; used server-side only.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against Acuity Scheduling immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP marks Acuity Scheduling as Connected and the appointment-type tool returns your real appointment types instead of an auth error.
Troubleshooting
401 Unauthorized
Why: The User ID and API Key are swapped, mistyped, or copied with surrounding whitespace. A stray leading space in the key is the most common cause.
Fix: Reopen Integrations, Analytics + Custom Integrations, API, view credentials, and re-copy both values. Make sure the numeric one goes in User ID.
No API block on the Integrations page
Why: You are signed in as a team member whose permissions exclude Business Settings, or on a sub-account rather than the owning account.
Fix: Sign in as the account owner or ask them to read the credentials for you.
The key stopped working after months of use
Why: Acuity does not email or rotate these on a schedule, so the same pair stays valid until somebody regenerates it.
Fix: Check whether a colleague clicked Regenerate API Key, then re-copy the current pair into PopMCP.
429 Too Many Requests
Why: Acuity limits callers to 10 requests per second and 20 concurrent connections per IP.
Fix: Space out bulk operations. The limit resets immediately, so a short retry with backoff clears it.