Acuity Scheduling

Overview

Connect your users to Acuity Scheduling for appointment booking, calendar management, and client scheduling.

Property	Value
Provider ID	acuity-scheduling
Category	Productivity
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create an Acuity Scheduling OAuth App

Go to the Acuity Scheduling Developer Portal

Navigate to the Acuity OAuth application registration page and sign in.

Register a new application

Register a new OAuth2 application.

Configure the application

Enter the application name and description. Add the Alter callback URL (from the Developer Portal) to the Redirect URI field.

Get credentials

Copy the Client ID and Client Secret.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Acuity Scheduling provider

Go to OAuth Providers > Add Provider > Acuity Scheduling.

Enter credentials

• Client ID: Paste your Acuity Scheduling Client ID
• Client Secret: Paste your Acuity Scheduling Client Secret

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
api-v1	Full access to the Acuity Scheduling API v1 (appointments, calendars, clients)

Note

The api-v1 scope is required for API access and is selected by default.

Notes

• Acuity Scheduling is owned by Squarespace. You may need a Squarespace account to access the developer portal.
• The api-v1 scope provides full access to appointments, calendars, and client data.
• See the Acuity Scheduling API documentation for more details on available endpoints.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
appointment-types/list	read	GET	/api/v1/appointment-types
appointments/create	write	POST	/api/v1/appointments
appointments/list	read	GET	/api/v1/appointments
appointments/get	read	GET	/api/v1/appointments/{id}
appointments/update	write	PUT	/api/v1/appointments/{id}
appointments/cancel	write	PUT	/api/v1/appointments/{id}/cancel
appointments/reschedule	write	PUT	/api/v1/appointments/{id}/reschedule
appointments/payments	read	GET	/api/v1/appointments/{id}/payments
availability/classes	read	GET	/api/v1/availability/classes
availability/dates	read	GET	/api/v1/availability/dates
availability/times	read	GET	/api/v1/availability/times
blocks/create	write	POST	/api/v1/blocks
blocks/list	read	GET	/api/v1/blocks
blocks/delete	delete	DELETE	/api/v1/blocks/{id}
calendars/list	read	GET	/api/v1/calendars
clients/create	write	POST	/api/v1/clients
clients/list	read	GET	/api/v1/clients
forms/list	read	GET	/api/v1/forms
labels/list	read	GET	/api/v1/labels
meta/get	read	GET	/api/v1/meta