Acuity Scheduling

Create, retrieve, update, cancel, and reschedule appointments. Manage availability by querying open dates and time slots for appointment types and calendars. Block time slots to prevent bookings. Manage client records including creation, retrieval, updates, and deletion. List appointment types, add-ons, calendars, and intake forms. Create and validate gift certificates, packages, and coupons. Retrieve orders and product listings.

Tools

Cancel Appointment

Cancel a scheduled appointment. Optionally include a cancellation note and suppress the cancellation email notification.

Check Availability

Check available dates for a given month or available time slots for a specific date. Provide a month to get available dates, or a date to get specific time slots. Both require an appointment type ID.

List Class Availability

Find group class sessions and remaining seats by month or date range. Returns appointment type IDs, calendar IDs, and times for booking.

List Certificates

Find package codes by client email, product, order, or appointment type before booking.

Create Appointment

Book a new appointment. Requires the appointment datetime, appointment type, and client details. Optionally provide a calendar, custom intake form field values, add-ons, and coupon/certificate codes.

Get Account Info

Retrieve information about the authenticated Acuity Scheduling account, including the account owner name, email, and timezone.

Get Appointment Payments

Retrieve payment information for a specific appointment.

Get Appointment

Retrieve full details of a specific appointment by ID, including client info, intake form responses, and payment status.

List Appointment Types

Retrieve all configured appointment types (service offerings) including their duration, pricing, and associated calendars. Also returns available add-ons.

List Appointments

Retrieve a list of scheduled appointments. Filter by date range, calendar, appointment type, client name, email, or phone. Defaults to 100 results. Set max to change the limit; use canceled to retrieve canceled appointments or showAll to include both states.

List Calendars

Retrieve all calendars (staff members or locations) configured in the account. Use calendar IDs when creating appointments or checking availability.

List Intake Forms

Retrieve all intake form definitions configured for the account. Forms are associated with appointment types and collect custom information from clients during booking. Use field IDs when creating or updating appointments with custom field values.

List Labels

Retrieve all labels used for categorizing and organizing appointments.

List Products

Retrieve all products and packages available in the online store.

Create Time Block

Block off a time range on a specific calendar to prevent appointment scheduling during that period.

Create Certificate

Create a certificate code for a package or coupon. Provide either a product ID (for packages) or a coupon ID (for coupons). Optionally specify a custom certificate code and assign it to an email.

List Clients

Search and retrieve client records. Filter by name, email, or phone number, or use a general search query.

Reschedule Appointment

Reschedule an existing appointment to a new date and time. Optionally change the calendar. The new datetime must be an available slot.

Update Appointment

Update an existing appointment's client details, notes, or intake form field values. To change the appointment time, use the Reschedule Appointment tool instead.

Client updates use currentFirstName and currentLastName, with currentPhone to distinguish clients with the same name. Client deletion uses firstName, lastName, and optional phone. Call List Clients first to discover these values; numeric client IDs are not used by Acuity's update or delete API.

Appointment notes and certificate updates require explicit admin: true. Administrator booking and rescheduling bypass availability validation, so check availability first. The noEmail option suppresses email and SMS notifications when creating, canceling, or rescheduling appointments. Availability checks support add-ons and, for a specific date, ignored appointment IDs when rescheduling to an overlapping slot.

License

This integration is licensed under the FSL-1.1.