Scheduling
Acuity Scheduling in your product and your AI agents, through one API
The Acuity Scheduling toolkit covers appointments, appointment types, calendars, availability, clients and intake forms. A product or AI agent can book, reschedule and cancel on behalf of the customer without building the Acuity integration or storing its credentials.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/acuity_create_appointment/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"datetime": "<datetime>",
"appointmentTypeID": 1,
"firstName": "<firstName>",
"lastName": "<lastName>"
}
}How it works
From a connected customer to the first Acuity Scheduling call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Acuity Scheduling account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Acuity Scheduling.
Booking inside your product
List available dates and times for an appointment type, then create the appointment from your own interface or from an agent conversation.
Rescheduling and cancellations
Let an AI assistant move or cancel an appointment when a client asks, with the client notified by Acuity's own email and SMS.
Syncing clients to a CRM
Read clients and appointments with their intake answers and push them into a CRM, or add new clients from your product to the Acuity client list.
Tools
13 Acuity Scheduling tools
- List appointmentsGETLists the scheduled appointments of the account, newest first by default, up to max per call. There is no page token: when a call returns max appointments, narrow minDate and maxDate. Canceled appointments only come with canceled or showall.
- Get appointmentGETReturns one appointment, with the client's name, email and phone, datetime, endTime, type, calendar, price, paid, notes, the intake answers in forms, labels and confirmationPage. A canceled appointment also has noShow.
- Create appointmentPOSTBooks an appointment and returns it. By default it is booked as a client would book it: the time must be open and the required intake fields answered. With admin true those checks are skipped and calendarID is required. The client gets the confirmation email and SMS unless noEmail is true.
- Update appointmentPUTUpdates the client details, intake answers or notes of an appointment and returns it. Only the fields sent change, and firstName and lastName cannot be cleared. Date, time and calendar change with Reschedule appointment.
- Cancel appointmentPUTCancels an appointment and returns it. A canceled appointment cannot be restored. By default the cancellation rules for clients apply; with admin true they are skipped and noShow can be set. The client gets the cancellation email and SMS unless noEmail is true.
- Reschedule appointmentPUTMoves an appointment to another date and time, another calendar or both, and returns it. The new time must be open unless admin is true. Canceled appointments and class series cannot be rescheduled. The client gets the rescheduling email and SMS unless noEmail is true.
- List appointment typesGETLists the appointment types, the services and classes that clients book, with id, name, duration in minutes, price, type (service, class or series), private and calendarIDs, the calendars that offer each one.
- List calendarsGETLists the calendars the account can access, usually one per staff member, with id, name, email, location and timezone.
- List available datesGETLists the dates of a month that have open times for an appointment type, the same dates the client scheduling page shows. Each item has date.
- List available timesGETLists the open start times of an appointment type on a date, the same times the client scheduling page shows. Each item has time, which goes as datetime to Create appointment or Reschedule appointment.
Username and password
Your customer enters the app credentials on a Connect screen, or your system sends them with POST /api/customer-toolkits, with no screen.
Questions about the Acuity Scheduling toolkit
Do I need to build against the Acuity Scheduling API?
No. Connect ships 13 Acuity Scheduling tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Acuity Scheduling account?
With the mode the toolkit accepts: Username and password. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
