Acuity Scheduling

Let your agent check availability and book, reschedule, or cancel appointments in your Acuity Scheduling  account — a good fit if your booking already lives in Acuity.

Setup

1. In Acuity, open Integrations → API and copy your User ID and API key — they work together as one credential.
2. Integrations → Add integration → Acuity Scheduling.
3. Name it (e.g. “Acuity booking”).
4. Paste the User ID (numeric) and API key. Both are stored encrypted and never shown again.
5. Optionally set a default appointment type ID (the numeric id to use when a call doesn’t specify one) and a timezone used to format times.
6. Click Add & discover tools.

Tools

Once connected, the agent can (prefixed with your integration’s slug):

• …_list_appointment_types — list the bookable services with durations and prices
• …_get_availability — check availability: pass a date for its open times, or a month (or nothing) for the days that have openings
• …_create_appointment — book an appointment (needs the caller’s name, email, and a time)
• …_reschedule_appointment — move an existing appointment to a new time
• …_cancel_appointment — cancel an appointment
• …_find_client — look up an existing client by name, email, or phone

Enable the ones you want per agent version in the builder’s Integration tools card.

Checking availability

Acuity availability is a two-step flow, and get_availability handles both:

• Pass a date (YYYY-MM-DD) to get the open times on that day.
• Pass a month (YYYY-MM), or nothing, to get the days in a month that have any openings — then call again with one of those dates for its times.

The agent typically finds a day first, then reads a few times from it.