Create Time Block

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

List Time Blocks

Retrieve a list of time blocks. Optionally filter by date range or calendar.

List Clients

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

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.

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.

Create Client

Create a new client record with contact information.

Delete Client

Permanently delete a client record.

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.

Get Appointment

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

Check Certificate

Validate a certificate or coupon code. Optionally check against a specific appointment type to verify eligibility.

List Appointment Types

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

List Orders

Retrieve all orders for packages, gift certificates, and subscriptions.

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.

Get Account Info

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

Reschedule Appointment

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

Cancel Appointment

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

Update Client

Update an existing client's contact information or notes.

Delete Certificate

Delete a certificate by ID.

List Labels

Retrieve all labels used for categorizing and organizing appointments.

Delete Time Block

Remove a time block to re-open that time slot for scheduling.

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 Products

Retrieve all products and packages available in the online store.

Get Appointment Payments

Retrieve payment information for a specific appointment.

List Appointments

Retrieve a list of scheduled appointments. Filter by date range, calendar, appointment type, client name, email, or phone. Returns up to 100 appointments per request.

List Calendars

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