acuityscheduling.com

•

One-click Login

About Acuity Scheduling

Acuity Scheduling is an online appointment booking tool owned by Squarespace. Clients self-schedule appointments via a branded booking page, with automatic email and SMS reminders reducing no-shows. It handles intake forms, payment collection via Stripe, Square, or PayPal, and time-zone auto-detection. It targets solo practitioners, small businesses, and multi-location service providers.

AI Agent Use Cases

- Client self-scheduling with real-time calendar availability

- Automated email and SMS reminders

- Payment collection and deposit capture at booking

- Customizable intake forms

- Multiple staff and location calendar management

- HIPAA compliance on Premium plan

Available Actions

These are the specific actions that AI agents can perform with this tool

Add Blocked Off Time

4 inputs

Creates a blocked time slot on your schedule to prevent appointments from being booked during that period.

Inputs

startTime

The starting time to block off (e.g.,

endTime

The ending time of the blocked off period (e.g.,

calendarId

Show only appointments on calendar with specified ID.

notes

Any notes to include for the blocked off time

Book Appointment

14 inputs

Schedule a new appointment by providing client and service details through Acuity Scheduling.

Inputs

datetime

Date and time of the appointment. E.g. `2016-02-03T14:00:00-0800`

appointmentTypeId

The type of appointment to book

firstName

First name of the client

lastName

Last name of the client

isAdmin

By default appointments are created as if they are being booked by a client. Booking as an admin disables availability and attribute validations, and allows setting the notes attribute. This also requires a valid `calendarID` to be included in the request.

Email address of the client

calendarId

The calendar to book the appointment on. If not provided we

phone

Phone number of the client

timezone

Timezone of the client. E.g. `America/Los_Angeles`

certificate

Package or coupon certificate code

notes

Notes to be added to the appointment. Settable when booking as an admin.

labelId

Label to be added to the appointment

smsOptin

Indicates whether the client has explicitly given their permission to receive SMS messages. This parameter is only applicable to Appointments with an Appointment Type that requires Opt In and can be omitted (and will be ignored) for all other Appointments. If omitted or set to false on an applicable Appointment, an SMS reminder will not be sent. For more information on SMS Opt In settings for Appointment Types, see the article in our [Knowledge Base](https://support.squarespace.com/hc/en-us/articles/360040093611).

formId

Enter form fields for the appointment. [See the documentation](https://developers.acuityscheduling.com/reference/post-appointments#setting-forms) for more information on setting form fields.

Check Availability Times

3 inputs

Checks and returns available appointment times for a specified date and service.

Inputs

date

Date to check availability for. E.g. `2016-02-03T14:00:00-0800`

appointmentTypeId

Appointment type to check availability time for

calendarId

Calendar to check availability time for

Find Appointments by Client Info

8 inputs

Retrieves a list of all appointments associated with a specific client using their identifying information.

Inputs

calendarID

Show only appointments on calendar with specified ID.

appointmentTypeID

Show only appointments of this type.

firstName

Filter appointments for client first name.

lastName

Filter appointments for client last name.

Filter appointments for client email address.

phone

Filter appointments for client phone.

customFields

Filter appointments matching a particular custom intake form field **eg. ?field:1234=Hello**

showAll

To retrieve both canceled and scheduled appointments.

Get Appointment Types

1 input

Retrieves a list of all appointment types available in the Acuity Scheduling account.

Inputs

includeDeleted

Include deleted appointment types in the response

Get Appointments

13 inputs

Retrieve a comprehensive list of scheduled appointments within Acuity Scheduling.

Inputs

minDate

Show appointments after this date (YYYY-MM-DD)

maxDate

Show appointments before this date (YYYY-MM-DD)

calendarId

Show only appointments on calendar with specified ID.

appointmentTypeId

Show only appointments of this type.

canceled

Show only canceled appointments

showall

Show both canceled and scheduled appointments

excludeForms

Don

Filter by client email address

firstName

Filter by client first name

lastName

Filter by client last name

phone

Filter by client phone number

max

Maximum number of appointments to return

direction

Sort direction

Get Availability Times

4 inputs

Retrieves available appointment times for a specified date and appointment type to facilitate booking.

Inputs

date

Date to get availability times for. E.g. `2016-02-03`

appointmentTypeId

Appointment type to get availability times for

calendarId

Calendar to get availability times for

timezone

Timezone of the client. E.g. `America/Los_Angeles`

Get Products

1 input

Retrieves a list of all available products and packages from the Acuity Scheduling account.

Inputs

deleted

Retrieve deleted products

About Acuity Scheduling

Available Actions

These are the specific actions that AI agents can perform with this tool

Add Blocked Off Time

4 inputs

Creates a blocked time slot on your schedule to prevent appointments from being booked during that period.

Inputs

startTime

The starting time to block off (e.g.,

endTime

The ending time of the blocked off period (e.g.,

calendarId

Show only appointments on calendar with specified ID.

notes

Any notes to include for the blocked off time

Book Appointment

14 inputs

Schedule a new appointment by providing client and service details through Acuity Scheduling.

Inputs

datetime

Date and time of the appointment. E.g. `2016-02-03T14:00:00-0800`

appointmentTypeId

The type of appointment to book

firstName

First name of the client

lastName

Last name of the client

isAdmin

Email address of the client

calendarId

The calendar to book the appointment on. If not provided we

phone

Phone number of the client

timezone

Timezone of the client. E.g. `America/Los_Angeles`

certificate

Package or coupon certificate code

notes

Notes to be added to the appointment. Settable when booking as an admin.

labelId

Label to be added to the appointment

smsOptin

formId

Enter form fields for the appointment. [See the documentation](https://developers.acuityscheduling.com/reference/post-appointments#setting-forms) for more information on setting form fields.

Check Availability Times

3 inputs

Checks and returns available appointment times for a specified date and service.

Inputs

date

Date to check availability for. E.g. `2016-02-03T14:00:00-0800`

appointmentTypeId

Appointment type to check availability time for

calendarId

Calendar to check availability time for

Find Appointments by Client Info

8 inputs

Retrieves a list of all appointments associated with a specific client using their identifying information.

Inputs

calendarID

Show only appointments on calendar with specified ID.

appointmentTypeID

Show only appointments of this type.

firstName

Filter appointments for client first name.

lastName

Filter appointments for client last name.

Filter appointments for client email address.

phone

Filter appointments for client phone.

customFields

Filter appointments matching a particular custom intake form field **eg. ?field:1234=Hello**

showAll

To retrieve both canceled and scheduled appointments.

Get Appointment Types

1 input

Retrieves a list of all appointment types available in the Acuity Scheduling account.

Inputs

includeDeleted

Include deleted appointment types in the response

Get Appointments

13 inputs

Retrieve a comprehensive list of scheduled appointments within Acuity Scheduling.

Inputs

minDate

Show appointments after this date (YYYY-MM-DD)

maxDate

Show appointments before this date (YYYY-MM-DD)

calendarId

Show only appointments on calendar with specified ID.

appointmentTypeId

Show only appointments of this type.

canceled

Show only canceled appointments

showall

Show both canceled and scheduled appointments

excludeForms

Don

Filter by client email address

firstName

Filter by client first name

lastName

Filter by client last name

phone

Filter by client phone number

max

Maximum number of appointments to return

direction

Sort direction

Get Availability Times

4 inputs

Retrieves available appointment times for a specified date and appointment type to facilitate booking.

Inputs

date

Date to get availability times for. E.g. `2016-02-03`

appointmentTypeId

Appointment type to get availability times for

calendarId

Calendar to get availability times for

timezone

Timezone of the client. E.g. `America/Los_Angeles`

Get Products

1 input

Retrieves a list of all available products and packages from the Acuity Scheduling account.

Inputs

deleted

Retrieve deleted products