Skip to main content

​
Overview

The Acuity Scheduling integration lets your agent generate booking links for your Acuity appointment types. The agent sends a scheduling link, and Acuity handles availability and booking.
Acuity Scheduling is available on all plans, including Free.

​
Connect Acuity

1

Open integrations

Go to your agent’s Integrations page.
2

Click Connect

Click Connect next to Acuity Scheduling. You’ll be redirected to Acuity’s OAuth consent screen.
3

Authorize access

Grant SetterMaxer AI access to your Acuity account.
4

Select an appointment type

Choose which appointment type the agent should use for booking links.

​
How it works

  1. When the lead is ready to book, the agent generates an Acuity scheduling link for your appointment type
  2. The lead books through Acuity’s scheduling interface
  3. Acuity sends a webhook notification (appointment.scheduled)
  4. SetterMaxer matches the booking to the conversation and marks it as booked
  5. A locale-aware confirmation message is sent in the chat

​
Booking matching

Acuity strips custom URL parameters during the booking redirect, so SetterMaxer uses FIFO matching instead:
  • When a booking link is generated, a pending booking record is created
  • When the Acuity webhook arrives, it’s matched to the oldest unmatched pending booking for that agent and appointment type
  • The matched session is marked as appointment_booked = true

​
WhatsApp support

For WhatsApp conversations, the booking confirmation is also delivered via the Meta API so the lead sees it in their WhatsApp chat.

​
Token management

Acuity uses a long-lived bearer token — no automatic refresh is needed. If your token is revoked, reconnect from the Integrations page.