List Appointments: Acuity Scheduling action

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Min Date minDate	string	Optional	ISO 8601 date
Max Date maxDate	string	Optional	Max Date
Max Results max	number	Optional	Max Results

Sample request

{
  "minDate": "{{trigger.minDate}}",
  "maxDate": "{{trigger.maxDate}}",
  "max": "{{trigger.max}}"
}

Returns

{
  "items": [
    {
      "id": 12345,
      "type": "Consultation",
      "email": "john@example.com",
      "datetime": "2026-04-15T14:00:00",
      "lastName": "Doe",
      "firstName": "John"
    }
  ]
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about List Appointments.

What does the List Appointments action do in Acuity Scheduling?

Returns paginated appointments filterable by date range, calendar, appointment type, or specific client. The workhorse for "morning workflow that lists today's appointments and prepares the practitioner's day" or "weekly capacity report" automations.

What inputs does List Appointments require?

List Appointments has no required inputs. Sensible defaults are applied if you leave fields blank.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if Acuity Scheduling returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does List Appointments support batch operations?

Yes. Run List Appointments inside a Loop node to process arrays. Tiny Command handles Acuity Scheduling's rate limits automatically so you don't have to throttle manually.

More actions

Other Acuity Scheduling actions.

Action

Cancel Appointment

Cancels a specific appointment by ID. Acuity sends the configured cancellation email to the client unless you suppress it. Useful for "no-show after 15 minutes → auto-cancel, free the slot" workflows or "practitioner sick → bulk-cancel today" admin automations.

Action

Get Appointment

Returns the full appointment record by ID — client, time, duration, payment status, intake form answers, calendar assignment. The standard lookup for workflows that need fresh state of an appointment whose ID was captured upstream (e.g., from a webhook a few minutes ago).

How do I list Acuity appointments for a date range?

The fields this action accepts.

Apps that pair well as the trigger for List Appointments.

Questions about List Appointments.

Other Acuity Scheduling actions.

Send list appointments from your workflows.