The Acuity Scheduling connector lets your AI agent act in each user's Acuity Scheduling account. Each user connects their own Acuity Scheduling API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.
- Tools
- 30
- What they doRead · write · destructive
- 21 · 6 · 321 read6 write3 destructive
- Users sign in with
- Username and password
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Acuity Scheduling connection
In AgentKit > Connections, create an Acuity Scheduling connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolacuityscheduling_appointment_addons_listList the add-ons configured in the Acuity account.Read-onlyList Appointment Add-ons
List the add-ons configured in the Acuity account. Returns each add-on's id, name, duration, price and private flag. Use this to get addon_ids for availability checks and bookings.
Inputs
This tool takes no inputs.
acuityscheduling_appointment_getGet one Acuity appointment by its numeric ID.Read-onlyGet Appointment
Get one Acuity appointment by its numeric ID. Returns the appointment's client details, datetime, endTime, type, calendar, price, payment status, certificate, intake forms, notes and labels. Use this when you already have the appointment ID. Use List Appointments to search by date or client.
Inputs
appointment_idintegerrequired- Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
past_form_answersboolean- Set true to include the client's previous answers to this appointment's intake forms. Example: true.
acuityscheduling_appointment_payments_listList the payment transactions recorded for one Acuity appointment.Read-onlyList Appointment Payments
List the payment transactions recorded for one Acuity appointment. Returns each transaction's ID, processor, amount and creation time. Use this to check how an appointment was paid. Use Get Appointment for the paid and amountPaid summary.
Inputs
appointment_idintegerrequired- Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
acuityscheduling_appointment_types_listList the appointment types offered in the Acuity account.Read-onlyList Appointment Types
List the appointment types offered in the Acuity account. Returns each type's id, name, duration, price, category, description, calendarIDs, form IDs and whether it is a class. Use this to get the appointment_type_id the availability and booking tools need.
Inputs
include_deletedboolean- Set true to include deleted appointment types. Example: true.
acuityscheduling_appointments_listList scheduled appointments in the Acuity account, filtered by date range, calendar, appointment type or client details.Read-onlyList Appointments
List scheduled appointments in the Acuity account, filtered by date range, calendar, appointment type or client details. Returns appointment objects with id, client name, email and phone, datetime, endTime, type, calendar, price, paid status, forms and labels. Use this to find appointments. Use Get Appointment for one appointment by ID. Set canceled to list canceled appointments instead.
Inputs
appointment_type_idinteger- Only return appointments of this appointment type. Get IDs from List Appointment Types. Example: 1.
calendar_idinteger- Only return appointments on this calendar. Get IDs from List Calendars. Example: 2.
canceledboolean- Set true to return canceled appointments instead of scheduled ones. Acuity defaults to false. Example: true.
directionstring- Sort order by appointment date: ASC or DESC. Acuity defaults to DESC. Example: ASC.one of
ASCDESC emailstring- Client e-mail address to filter by. Example: bob.mctest@example.com.
exclude_formsboolean- Set true to leave intake form answers out of the response, which makes it faster. Example: true.
first_namestring- Client first name to filter by. Example: Bob.
last_namestring- Client last name to filter by. Example: McTest.
maxinteger- Maximum number of results to return. Acuity defaults to 100. Example: 50.
max_datestring- Only return appointments on or before this date (YYYY-MM-DD). Example: 2026-01-31.
min_datestring- Only return appointments on or after this date (YYYY-MM-DD). Example: 2026-01-01.
phonestring- Client phone number to filter by, with the country code. Example: +15551234567.
acuityscheduling_availability_classes_listList scheduled class sessions with open spots in Acuity, for a month or date range.Read-onlyGet Available Classes
List scheduled class sessions with open spots in Acuity, for a month or date range. Returns each class session's id, appointmentTypeID, calendarID, name, time, duration, slots and slotsAvailable. Use this for class (group) appointment types. Use Get Available Times for one-on-one types.
Inputs
appointment_type_idinteger- Only return classes of this appointment type. By default all class types are checked. Example: 5.
calendar_idinteger- Numeric ID of a calendar to limit to. Get it from List Calendars. Example: 2.
include_privateboolean- Set true to also list classes marked private. Example: true.
include_unavailableboolean- Set true to also list classes that are full or no longer bookable. Example: true.
max_datestring- Only return classes on or before this date (YYYY-MM-DD). Example: 2026-01-31.
min_datestring- Only return classes on or after this date (YYYY-MM-DD). Example: 2026-01-01.
monthstring- Month to check, as YYYY-MM. Overrides min_date and max_date. Example: 2026-02.
timezonestring- IANA time zone used to convert the returned times. Example: America/New_York.
acuityscheduling_availability_dates_listList the dates in a month that have open slots for an Acuity appointment type.Read-onlyGet Available Dates
List the dates in a month that have open slots for an Acuity appointment type. Returns a list of objects with a date (YYYY-MM-DD). Use this first to find bookable days, then Get Available Times for the slots on a day.
Inputs
appointment_type_idintegerrequired- Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
monthstringrequired- Month to check, as YYYY-MM. Example: 2026-02.
addon_idsarray- Add-on IDs to include when calculating availability. The add-ons must belong to the appointment type. Get IDs from List Appointment Add-ons. Example: [3, 4].
calendar_idinteger- Numeric ID of a calendar to limit to. Get it from List Calendars. Example: 2.
timezonestring- IANA time zone used to convert the returned times. Example: America/New_York.
acuityscheduling_availability_time_checkCheck whether one date and time is open for an Acuity appointment type before booking it.Read-onlyCheck Available Time
Check whether one date and time is open for an Acuity appointment type before booking it. Returns the checked datetime, appointmentTypeID and calendarID with valid set to true when the slot is open; Acuity returns an error when it is not. Use this right before Create Appointment to confirm a slot. It books nothing.
Inputs
appointment_type_idintegerrequired- Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
datetimestringrequired- Date and time to check, parsed in the business time zone. ISO 8601 is safest. Example: 2026-02-03T14:00:00-0800.
calendar_idinteger- Calendar to check. If omitted, any available calendar counts. Example: 2.
acuityscheduling_availability_times_listList the open time slots on one date for an Acuity appointment type.Read-onlyGet Available Times
List the open time slots on one date for an Acuity appointment type. Returns a list of open slots, each with its time as an ISO 8601 date-time. Use this after Get Available Dates to choose a slot for Create Appointment or Reschedule Appointment. Use Get Available Classes for class types.
Inputs
appointment_type_idintegerrequired- Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
datestringrequired- Date to check, as YYYY-MM-DD. Example: 2026-02-03.
addon_idsarray- Add-on IDs to include when calculating availability. The add-ons must belong to the appointment type. Get IDs from List Appointment Add-ons. Example: [3, 4].
calendar_idinteger- Numeric ID of a calendar to limit to. Get it from List Calendars. Example: 2.
ignore_appointment_idsarray- Appointment IDs whose slots count as free, so an appointment being rescheduled does not block its own time. Example: [31991639].
timezonestring- IANA time zone used to convert the returned times. Example: America/New_York.
acuityscheduling_block_getGet one blocked-off time in Acuity by its numeric ID.Read-onlyGet Blocked Time
Get one blocked-off time in Acuity by its numeric ID. Returns the block's id, calendarID, start, end, notes and description. Use List Blocked Times to find block IDs.
Inputs
block_idintegerrequired- Numeric ID of the blocked time. Get it from List Blocked Times. Example: 1234.
acuityscheduling_blocks_listList blocked-off times on the Acuity account's calendars.Read-onlyList Blocked Times
List blocked-off times on the Acuity account's calendars. Returns each block's id, calendarID, start, end, until, recurring flag, notes and description. Use this to see when calendars are unavailable. Use Get Blocked Time for one block by ID.
Inputs
calendar_idinteger- Only return blocks on this calendar. Example: 2.
maxinteger- Maximum number of results to return. Acuity defaults to 100. Example: 50.
max_datestring- Only return blocks on or before this date (YYYY-MM-DD). Example: 2026-01-31.
min_datestring- Only return blocks on or after this date (YYYY-MM-DD). Example: 2026-01-01.
acuityscheduling_calendars_listList the calendars the authenticated Acuity user can access.Read-onlyList Calendars
List the calendars the authenticated Acuity user can access. Returns each calendar's id, name, email, replyTo, description, location and timezone. Use this to get a calendar_id for filtering, availability and booking.
Inputs
This tool takes no inputs.
acuityscheduling_certificate_checkCheck that a package or coupon certificate code can be used for an Acuity appointment type.Read-onlyCheck Certificate
Check that a package or coupon certificate code can be used for an Acuity appointment type. Returns the certificate's details when valid; Acuity returns an error naming the reason when it is not. Use this before Create Appointment with a certificate. Use List Certificates to find codes.
Inputs
appointment_type_idintegerrequired- Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
certificatestringrequired- Certificate code to check. Example: ABC123.
emailstring- Client e-mail to check the code for, for example for coupon use. Example: bob.mctest@example.com.
acuityscheduling_certificates_listList package and coupon certificate codes in Acuity, filtered by product, order, appointment type or client e-mail.Read-onlyList Certificates
List package and coupon certificate codes in Acuity, filtered by product, order, appointment type or client e-mail. Returns each certificate's id, certificate code, name, type, productID, orderID, appointmentTypeIDs, remainingCounts or remainingMinutes, expiration and email. Use this to suggest codes for a client. Use Check Certificate to validate one code for an appointment type.
Inputs
appointment_type_idstring- Only return codes usable for this appointment type. Example: 1.
emailstring- Only return valid codes assigned to this e-mail address. Example: bob.mctest@example.com.
order_idstring- Only return codes for this order. Example: 1234.
product_idstring- Only return codes for this product. Example: 2.
acuityscheduling_clients_listList clients in the Acuity account, optionally filtered by a search term.Read-onlyList Clients
List clients in the Acuity account, optionally filtered by a search term. Returns each client's firstName, lastName, email, phone and notes. Use this to look up a client before booking, updating or deleting.
Inputs
searchstring- Text to match against client first name, last name or phone number. Example: McTest.
acuityscheduling_forms_listList the intake forms in the Acuity account with their fields.Read-onlyList Intake Forms
List the intake forms in the Acuity account with their fields. Returns each form's id, name, description, hidden flag, appointment type IDs and fields with field id, name, type, options and required flag. Use this to get the field IDs for the fields input of Create Appointment and Update Appointment.
Inputs
This tool takes no inputs.
acuityscheduling_labels_listList the appointment labels defined in the Acuity account.Read-onlyList Labels
List the appointment labels defined in the Acuity account. Returns each label's id, name and color. Use this to get a label ID for the labels input of Create Appointment and Update Appointment.
Inputs
This tool takes no inputs.
acuityscheduling_me_getGet basic information about the authenticated Acuity account.Read-onlyGet Account
Get basic information about the authenticated Acuity account. Returns the account id, email, name, timezone, currency, plan, schedulingPage URL and embedCode. Use this to confirm which account is connected.
Inputs
This tool takes no inputs.
acuityscheduling_order_getGet one Acuity online store order by its numeric ID.Read-onlyGet Order
Get one Acuity online store order by its numeric ID. Returns the order's id, total, status, time, client details and title. Use List Orders to find order IDs.
Inputs
order_idintegerrequired- Numeric ID of the order. Get it from List Orders. Example: 1234.
acuityscheduling_orders_listList orders from the Acuity online store, most recent first.Read-onlyList Orders
List orders from the Acuity online store, most recent first. Returns each order's id, total, status (delivered, paid or unpaid), time, client name, email and title listing the products ordered. Use Get Order for one order by ID.
Inputs
maxinteger- Maximum number of results to return. Acuity defaults to 100. Example: 50.
acuityscheduling_products_listList the products, packages, gift certificates and subscriptions sold in the Acuity online store.Read-onlyList Products
List the products, packages, gift certificates and subscriptions sold in the Acuity online store. Returns each product's id, name, description, price, type, hidden flag, expires, appointmentTypeIDs and minutes. Use this to get a product ID for List Certificates.
Inputs
deletedboolean- Set true to list deleted products. Example: true.
acuityscheduling_appointment_createBook a new appointment in Acuity for a client at a given date and time.WriteCreate Appointment
Book a new appointment in Acuity for a client at a given date and time. Returns the created appointment with its id, datetime, calendar, price and confirmation page URL. Use Get Available Times or Check Available Time first to pick an open slot. Set admin to book outside availability rules or to set notes. Acuity e-mails the client unless no_email is true.
Inputs
appointment_type_idintegerrequired- Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
datetimestringrequired- Date and time of the appointment, parsed in the business or calendar time zone. ISO 8601 is safest. Example: 2026-02-03T14:00:00-0800.
emailstringrequired- Client e-mail address. Acuity treats it as optional only when admin is true, but this tool requires it. Example: bob.mctest@example.com.
first_namestringrequired- Client first name. Example: Bob.
last_namestringrequired- Client last name. Example: McTest.
addon_idsarray- Add-on IDs to include in the appointment. They must belong to the appointment type. Get IDs from List Appointment Add-ons. Example: [3].
adminboolean- Set true to act as the account admin instead of as a client. Admin mode skips availability and attribute validation and allows setting admin-only fields such as notes and certificate. Example: true.
calendar_idinteger- Calendar to book on. If omitted, Acuity picks an available calendar. Get IDs from List Calendars. Example: 2.
certificatestring- Package or coupon certificate code to apply. Example: ABC123.
fieldsarray- Intake form answers, one object per form field with the field's numeric id and the value to set. Field IDs come from List Intake Forms. File fields take a URL to a file hosted elsewhere. Example: [{"id": 1, "value": "Party time!"}].
labelsarray- Label to apply to the appointment, as a list holding one object with the label's id. Acuity accepts only one label. Label IDs come from List Labels. Example: [{"id": 3}].
no_emailboolean- Set true to skip the confirmation e-mail and SMS Acuity would otherwise send to the client for this change. Example: true.
notesstring- Appointment notes. Only settable when admin is true. Example: Prefers the window seat.
phonestring- Client phone number. May be required by the account's settings. Example: +15551234567.
sms_opt_inboolean- Set true when the client has explicitly agreed to receive SMS messages. Applies only to appointment types with SMS reminders enabled. Example: true.
timezonestring- Client's IANA time zone. Example: America/New_York.
acuityscheduling_appointment_rescheduleMove an Acuity appointment to a new date and time, optionally on another calendar.WriteReschedule Appointment
Move an Acuity appointment to a new date and time, optionally on another calendar. Returns the rescheduled appointment. Use Get Available Times first to find an open slot; pass the appointment ID in its ignore list. Set admin to skip availability checks. Acuity notifies the client unless no_email is true.
- Idempotent
Inputs
appointment_idintegerrequired- Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
datetimestringrequired- New date and time, parsed in the business time zone. ISO 8601 is safest. Example: 2026-02-04T10:00:00-0800.
adminboolean- Set true to act as the account admin instead of as a client. Admin mode skips availability and attribute validation and allows setting admin-only fields such as notes and certificate. Example: true.
calendar_idinteger- Calendar to move the appointment to. If omitted, it stays on its current calendar. Example: 2.
no_emailboolean- Set true to skip the confirmation e-mail and SMS Acuity would otherwise send to the client for this change. Example: true.
timezonestring- Client's IANA time zone. Example: America/New_York.
acuityscheduling_appointment_updateUpdate the client details, intake form answers, notes or label of an existing Acuity appointment.WriteUpdate Appointment
Update the client details, intake form answers, notes or label of an existing Acuity appointment. Returns the updated appointment. Use this to edit details. Use Reschedule Appointment to change the time and Cancel Appointment to cancel it. Notes and certificate need admin set to true.
- Idempotent
Inputs
appointment_idintegerrequired- Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
adminboolean- Set true to act as the account admin instead of as a client. Admin mode skips availability and attribute validation and allows setting admin-only fields such as notes and certificate. Example: true.
certificatestring- Package or coupon certificate code. Only settable when admin is true. Example: ABC123.
emailstring- Client e-mail address. Example: bob.mctest@example.com.
fieldsarray- Intake form answers, one object per form field with the field's numeric id and the value to set. Field IDs come from List Intake Forms. File fields take a URL to a file hosted elsewhere. Example: [{"id": 1, "value": "Party time!"}].
first_namestring- Client first name. Cannot be removed. Example: Bob.
labelsarray- Label to apply to the appointment, as a list holding one object with the label's id. Acuity accepts only one label. Label IDs come from List Labels. Example: [{"id": 3}].
last_namestring- Client last name. Cannot be removed. Example: McTest.
notesstring- Appointment notes. Only settable when admin is true. Example: Prefers the window seat.
phonestring- Client phone number. Example: +15551234567.
sms_opt_inboolean- Set true when the client has explicitly agreed to receive SMS messages. Applies only to appointment types with SMS reminders enabled. Example: true.
acuityscheduling_block_createBlock off a period on an Acuity calendar so no appointments can be booked in it.WriteCreate Blocked Time
Block off a period on an Acuity calendar so no appointments can be booked in it. Returns the created block with its id, start, end and calendarID. Use Delete Blocked Time to remove it later.
Inputs
calendar_idintegerrequired- Calendar to block. Get IDs from List Calendars. Example: 2.
endstringrequired- End of the blocked period. Example: 2026-02-03T13:00:00-0800.
startstringrequired- Start of the blocked period, parsed in the business time zone. ISO 8601 is safest. Example: 2026-02-03T12:00:00-0800.
notesstring- Notes for the blocked period. Example: Lunch.
acuityscheduling_client_createAdd a client to the Acuity client list.WriteCreate Client
Add a client to the Acuity client list. Returns the created client. Use this to add a client without booking. Create Appointment adds the client automatically.
Inputs
first_namestringrequired- Client first name. Example: Bob.
last_namestringrequired- Client last name. Example: McTest.
emailstring- Client e-mail address. Example: bob.mctest@example.com.
notesstring- Notes about the client. Example: Referred by Jane.
phonestring- Client phone number. Example: +15551234567.
acuityscheduling_client_updateUpdate a client in the Acuity client list, found by their current first name, last name and optional phone.WriteUpdate Client
Update a client in the Acuity client list, found by their current first name, last name and optional phone. Returns the updated client. Acuity finds clients by name, not ID: pass the current name in the lookup fields and the values to save in the other fields. Use List Clients to confirm the current name.
- Idempotent
Inputs
first_namestringrequired- Client first name to save. Example: Bob.
last_namestringrequired- Client last name to save. Example: McTest.
lookup_first_namestringrequired- Current first name of the client to update. Example: Bob.
lookup_last_namestringrequired- Current last name of the client to update. Example: McTest.
emailstring- Client e-mail address to save. Example: bob.mctest@example.com.
lookup_phonestring- Current phone number, to tell apart clients with the same name. Example: +15551234567.
notesstring- Notes to save on the client. Example: Prefers mornings.
phonestring- Client phone number to save. Example: +15551234567.
acuityscheduling_appointment_cancelCancel an Acuity appointment, optionally with a note sent to the client.DestructiveCancel Appointment
Cancel an Acuity appointment, optionally with a note sent to the client. Returns the canceled appointment. Use this to cancel. Use Reschedule Appointment to move it instead. Set admin to bypass cancellation rules or to mark a no-show. Acuity notifies the client unless no_email is true.
- Idempotent
Inputs
appointment_idintegerrequired- Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
adminboolean- Set true to act as the account admin instead of as a client. Admin mode skips availability and attribute validation and allows setting admin-only fields such as notes and certificate. Example: true.
cancel_notestring- Message included in the cancellation notification. Example: The office is closed that day.
no_emailboolean- Set true to skip the confirmation e-mail and SMS Acuity would otherwise send to the client for this change. Example: true.
no_showboolean- Set true to mark the appointment as a no-show. Only settable when admin is true. Example: true.
acuityscheduling_block_deleteDelete a blocked-off time from an Acuity calendar, reopening that period for booking.DestructiveDelete Blocked Time
Delete a blocked-off time from an Acuity calendar, reopening that period for booking. Returns an empty response on success. Use List Blocked Times to find the block ID.
- Idempotent
Inputs
block_idintegerrequired- Numeric ID of the blocked time to delete. Example: 1234.
acuityscheduling_client_deleteDelete a client from the Acuity client list, found by first name, last name and optional phone.DestructiveDelete Client
Delete a client from the Acuity client list, found by first name, last name and optional phone. Returns an empty response on success; Acuity returns 400 if no client matches. Use List Clients first to confirm the exact name.
- Idempotent
Inputs
first_namestringrequired- Client first name of the client to delete. Example: Bob.
last_namestringrequired- Client last name of the client to delete. Example: McTest.
phonestring- Client phone number of the client to delete, to tell apart clients with the same name. Example: +15551234567.
No tools match.