Acuity

Scheduling integration · 19 node(s) including 1 trigger.

00Overview

Manage Acuity Scheduling appointments, availability, clients, appointment types and calendars

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Acuity

Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:

Field	Type		Details
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Appointment

Acuity: Cancel Appointment

scheduling/acuity/appointment_cancel · Action

Cancel an Acuity appointment, optionally with a note.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment ID	`integer`	Required
Cancellation Note	`text`		Reason shared internally (optional)
Admin Cancel	`boolean`		Bypass cancellation restrictions
Suppress Emails	`boolean`

Returns: id, result, tool_result, success, error

Acuity: Book Appointment

scheduling/acuity/appointment_create · Action

Book a new Acuity appointment for a client at a given date and time.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment Type ID	`integer`	Required
Date & Time	`string`	Required	2026-07-10T09:00:00-0700 (ISO 8601)
First Name	`string`	Required
Last Name	`string`	Required
Email	`string`	Required	client@example.com
Calendar ID	`integer`		Assign to a calendar (optional)
Phone	`string`		Client phone (optional)
Time Zone	`string`		America/New_York (optional)
Certificate	`string`		Package/coupon code (optional)
Notes	`text`		Appointment notes (optional)
Intake Form Fields (JSON array, advanced)	`object`		[{"id":1,"value":"answer"}]
Admin Booking	`boolean`		Bypass availability/booking limits
Suppress Emails	`boolean`		Do not send confirmation emails

Returns: id, result, tool_result, success, error

Acuity: Get Appointment

scheduling/acuity/appointment_get · Action

Retrieve a single Acuity appointment by its ID.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment ID	`integer`	Required

Returns: id, result, tool_result, success, error

Acuity: Get Many Appointments

scheduling/acuity/appointment_get_all · Action

List Acuity appointments, filtered by date range, calendar, type, client details or cancellation state.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Start Date	`string`		2026-07-01 (optional)
End Date	`string`		2026-07-31 (optional)
Calendar ID	`integer`		Filter to a calendar (optional)
Appointment Type ID	`integer`		Filter to a type (optional)
First Name	`string`		Filter by client first name (optional)
Last Name	`string`		Filter by client last name (optional)
Email	`string`		Filter by client email (optional)
Phone	`string`		Filter by client phone (optional)
Include Canceled	`boolean`		Return canceled appointments
Sort Direction	`string`		choices: Newest First, Oldest First
Max Results	`integer`		1-1000, default 100

Returns: results, count, tool_result, success, error

Acuity: Get Appointment Payments

scheduling/acuity/appointment_payments · Action

List the payment transactions recorded against an Acuity appointment.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment ID	`integer`	Required

Returns: results, count, tool_result, success, error

Acuity: Reschedule Appointment

scheduling/acuity/appointment_reschedule · Action

Move an Acuity appointment to a new date and time (and optionally a different calendar).

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment ID	`integer`	Required
New Date & Time	`string`	Required	2026-07-11T09:00:00-0700 (ISO 8601)
Calendar ID	`integer`		Move to a different calendar (optional)
Admin Reschedule	`boolean`		Bypass availability checks
Suppress Emails	`boolean`

Returns: id, result, tool_result, success, error

Acuity: Get Many Appointment Types

scheduling/acuity/appointment_type_get_all · Action

List your Acuity appointment types (the bookable services and classes).

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Include Deleted	`boolean`		Also return deleted appointment types

Returns: results, count, tool_result, success, error

Acuity: Update Appointment

scheduling/acuity/appointment_update · Action

Update a client's details or notes on an Acuity appointment. Only supplied fields change.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment ID	`integer`	Required
First Name	`string`		New first name (optional)
Last Name	`string`		New last name (optional)
Email	`string`		New email (optional)
Phone	`string`		New phone (optional)
Notes	`text`		New notes (optional)
Intake Form Fields (JSON array, advanced)	`object`		[{"id":1,"value":"answer"}]
Admin Update	`boolean`		Bypass restrictions
Suppress Emails	`boolean`

Returns: id, result, tool_result, success, error

03Availability

Acuity: Check Time Availability

scheduling/acuity/availability_check_times · Action

Validate whether a specific date/time is bookable for an Acuity appointment type before booking it.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment Type ID	`integer`	Required
Date & Time	`string`	Required	2026-07-10T09:00:00-0700 (ISO 8601)
Calendar ID	`integer`		Check against a calendar (optional)

Returns: results, count, tool_result, success, error

Acuity: Get Available Classes

scheduling/acuity/availability_classes · Action

List the class offerings (group appointments) available in a month for an Acuity appointment type.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment Type ID	`integer`	Required
Month	`string`	Required	2026-07 (YYYY-MM)
Include Full/Unavailable	`boolean`		Also return classes with no open spots
Time Zone	`string`		America/New_York (optional)

Returns: results, count, tool_result, success, error

Acuity: Get Available Dates

scheduling/acuity/availability_dates · Action

List the dates in a month that have availability for an Acuity appointment type.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment Type ID	`integer`	Required
Month	`string`	Required	2026-07 (YYYY-MM)
Calendar ID	`integer`		Limit to a calendar (optional)
Time Zone	`string`		America/New_York (optional)

Returns: results, count, tool_result, success, error

Acuity: Get Available Times

scheduling/acuity/availability_times · Action

List the available start times on a given date for an Acuity appointment type.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Appointment Type ID	`integer`	Required
Date	`string`	Required	2026-07-10 (YYYY-MM-DD)
Calendar ID	`integer`		Limit to a calendar (optional)
Time Zone	`string`		America/New_York (optional)

Returns: results, count, tool_result, success, error

04Calendar

Acuity: Get Many Calendars

scheduling/acuity/calendar_get_all · Action

List the calendars (staff/resources) configured in your Acuity account.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)

Returns: results, count, tool_result, success, error

05Client

Acuity: Create Client

scheduling/acuity/client_create · Action

Add a new client to your Acuity address book.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
First Name	`string`	Required
Last Name	`string`	Required
Email	`string`		client@example.com (optional)
Phone	`string`		Client phone (optional)
Notes	`text`		Internal notes (optional)

Returns: id, result, tool_result, success, error

Acuity: Delete Client

scheduling/acuity/client_delete · Action

Remove a client from your Acuity address book. The client is identified by first name, last name and phone.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
First Name	`string`	Required
Last Name	`string`	Required
Phone	`string`	Required

Returns: tool_result, success, error

Acuity: Get Many Clients

scheduling/acuity/client_get_all · Action

List your Acuity clients, optionally filtered by a search term (name, email or phone).

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
Search	`string`		Name, email or phone (optional)

Returns: results, count, tool_result, success, error

Acuity: Update Client

scheduling/acuity/client_update · Action

Update an Acuity client's email or notes. The client is identified by first name, last name and phone.

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)
First Name	`string`	Required	Identifies the client
Last Name	`string`	Required	Identifies the client
Phone	`string`	Required	Identifies the client
Email	`string`		New email (optional)
Notes	`text`		New notes (optional)

Returns: id, result, tool_result, success, error

06Me

Acuity: Get Account

scheduling/acuity/me_get · Action

Retrieve the authenticated Acuity account profile (name, email, timezone, currency).

Field	Type		Details
Acuity User ID	`string`	Required
Acuity API Key	`secret`	Required	Acuity API key (Basic-auth password)

Returns: id, result, tool_result, success, error

07Triggers

Acuity Scheduling Trigger

trigger/acuity_webhook · Trigger

Triggers a flow when an Acuity Scheduling event occurs (appointment scheduled/rescheduled/canceled/changed, or order completed). The webhook subscription is registered with Acuity automatically.

Field	Type		Details
Acuity User ID	`string`	Required	Used to register the webhook
Acuity API Key	`secret`	Required	Used to register the webhook and verify signatures
Events	`multi_select`	Required	choices: Appointment Scheduled, Appointment Rescheduled, Appointment Canceled, Appointment Changed (any change), Order Completed
Resolve Full Object	`boolean`		Fetch the full appointment/order (Acuity only sends its ID). Default on.

Returns: content, event, object_id, calendar_id, appointment_type_id, appointment, body, triggered_at

08Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

Acuity's API is available only on their Powerhouse plan, so every action here returns an access-denied error on Basic, Emerging or Growing accounts regardless of correct credentials.
Client actions identify a person by the combination of first name, last name and phone rather than a numeric ID, so updating or deleting a client requires those three fields to match an existing record exactly and can be ambiguous when duplicates exist.
Validate a slot with the check-times action immediately before booking, as availability can change between listing free times and creating the appointment.
Appointment and client lists are bounded by your date and count filters rather than paged, so widen the date range or raise the maximum if you expect more results than come back.