> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Acuity Scheduling

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.

**Authentication:** User ID + API Key
**Categories:** Calendar, Productivity
**Tools:** 30: 21 read, 6 write, 3 destructive
**Users sign in with:** Username and password
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ACUITYSCHEDULING)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Acuity Scheduling connection

   In **AgentKit > Connections**, create an Acuity Scheduling connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'acuityscheduling_appointment_addons_list',
  toolInput: {},
  connector: 'acuityscheduling',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="acuityscheduling_appointment_addons_list",
    tool_input={},
    connection_name="acuityscheduling",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `acuityscheduling_appointment_addons_list`

List Appointment Add-ons · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `acuityscheduling_appointment_get`

Get Appointment · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_id` (`integer`, required): Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
- `past_form_answers` (`boolean`, optional): Set true to include the client's previous answers to this appointment's intake forms. Example: true.

Example input: `{"appointment_id":31991639}`

### `acuityscheduling_appointment_payments_list`

List Appointment Payments · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_id` (`integer`, required): Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.

Example input: `{"appointment_id":31991639}`

### `acuityscheduling_appointment_types_list`

List Appointment Types · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `include_deleted` (`boolean`, optional): Set true to include deleted appointment types. Example: true.

Example input: `{}`

### `acuityscheduling_appointments_list`

List Appointments · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_type_id` (`integer`, optional): Only return appointments of this appointment type. Get IDs from List Appointment Types. Example: 1.
- `calendar_id` (`integer`, optional): Only return appointments on this calendar. Get IDs from List Calendars. Example: 2.
- `canceled` (`boolean`, optional): Set true to return canceled appointments instead of scheduled ones. Acuity defaults to false. Example: true.
- `direction` (`string`, optional): Sort order by appointment date: ASC or DESC. Acuity defaults to DESC. Example: ASC. One of: `ASC`, `DESC`.
- `email` (`string`, optional): Client e-mail address to filter by. Example: bob.mctest@example.com.
- `exclude_forms` (`boolean`, optional): Set true to leave intake form answers out of the response, which makes it faster. Example: true.
- `first_name` (`string`, optional): Client first name to filter by. Example: Bob.
- `last_name` (`string`, optional): Client last name to filter by. Example: McTest.
- `max` (`integer`, optional): Maximum number of results to return. Acuity defaults to 100. Example: 50.
- `max_date` (`string`, optional): Only return appointments on or before this date (YYYY-MM-DD). Example: 2026-01-31.
- `min_date` (`string`, optional): Only return appointments on or after this date (YYYY-MM-DD). Example: 2026-01-01.
- `phone` (`string`, optional): Client phone number to filter by, with the country code. Example: +15551234567.

Example input: `{}`

### `acuityscheduling_availability_classes_list`

Get Available Classes · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_type_id` (`integer`, optional): Only return classes of this appointment type. By default all class types are checked. Example: 5.
- `calendar_id` (`integer`, optional): Numeric ID of a calendar to limit to. Get it from List Calendars. Example: 2.
- `include_private` (`boolean`, optional): Set true to also list classes marked private. Example: true.
- `include_unavailable` (`boolean`, optional): Set true to also list classes that are full or no longer bookable. Example: true.
- `max_date` (`string`, optional): Only return classes on or before this date (YYYY-MM-DD). Example: 2026-01-31.
- `min_date` (`string`, optional): Only return classes on or after this date (YYYY-MM-DD). Example: 2026-01-01.
- `month` (`string`, optional): Month to check, as YYYY-MM. Overrides min_date and max_date. Example: 2026-02.
- `timezone` (`string`, optional): IANA time zone used to convert the returned times. Example: America/New_York.

Example input: `{}`

### `acuityscheduling_availability_dates_list`

Get Available Dates · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_type_id` (`integer`, required): Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
- `month` (`string`, required): Month to check, as YYYY-MM. Example: 2026-02.
- `addon_ids` (`array`, optional): 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_id` (`integer`, optional): Numeric ID of a calendar to limit to. Get it from List Calendars. Example: 2.
- `timezone` (`string`, optional): IANA time zone used to convert the returned times. Example: America/New_York.

Example input: `{"appointment_type_id":1,"month":"<month>"}`

### `acuityscheduling_availability_time_check`

Check Available Time · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_type_id` (`integer`, required): Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
- `datetime` (`string`, required): Date and time to check, parsed in the business time zone. ISO 8601 is safest. Example: 2026-02-03T14:00:00-0800.
- `calendar_id` (`integer`, optional): Calendar to check. If omitted, any available calendar counts. Example: 2.

Example input: `{"appointment_type_id":1,"datetime":"<datetime>"}`

### `acuityscheduling_availability_times_list`

Get Available Times · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_type_id` (`integer`, required): Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
- `date` (`string`, required): Date to check, as YYYY-MM-DD. Example: 2026-02-03.
- `addon_ids` (`array`, optional): 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_id` (`integer`, optional): Numeric ID of a calendar to limit to. Get it from List Calendars. Example: 2.
- `ignore_appointment_ids` (`array`, optional): Appointment IDs whose slots count as free, so an appointment being rescheduled does not block its own time. Example: [31991639].
- `timezone` (`string`, optional): IANA time zone used to convert the returned times. Example: America/New_York.

Example input: `{"appointment_type_id":1,"date":"<date>"}`

### `acuityscheduling_block_get`

Get Blocked Time · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `block_id` (`integer`, required): Numeric ID of the blocked time. Get it from List Blocked Times. Example: 1234.

Example input: `{"block_id":1234}`

### `acuityscheduling_blocks_list`

List Blocked Times · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `calendar_id` (`integer`, optional): Only return blocks on this calendar. Example: 2.
- `max` (`integer`, optional): Maximum number of results to return. Acuity defaults to 100. Example: 50.
- `max_date` (`string`, optional): Only return blocks on or before this date (YYYY-MM-DD). Example: 2026-01-31.
- `min_date` (`string`, optional): Only return blocks on or after this date (YYYY-MM-DD). Example: 2026-01-01.

Example input: `{}`

### `acuityscheduling_calendars_list`

List Calendars · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `acuityscheduling_certificate_check`

Check Certificate · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_type_id` (`integer`, required): Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
- `certificate` (`string`, required): Certificate code to check. Example: ABC123.
- `email` (`string`, optional): Client e-mail to check the code for, for example for coupon use. Example: bob.mctest@example.com.

Example input: `{"appointment_type_id":1,"certificate":"<certificate>"}`

### `acuityscheduling_certificates_list`

List Certificates · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_type_id` (`string`, optional): Only return codes usable for this appointment type. Example: 1.
- `email` (`string`, optional): Only return valid codes assigned to this e-mail address. Example: bob.mctest@example.com.
- `order_id` (`string`, optional): Only return codes for this order. Example: 1234.
- `product_id` (`string`, optional): Only return codes for this product. Example: 2.

Example input: `{}`

### `acuityscheduling_clients_list`

List Clients · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `search` (`string`, optional): Text to match against client first name, last name or phone number. Example: McTest.

Example input: `{}`

### `acuityscheduling_forms_list`

List Intake Forms · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `acuityscheduling_labels_list`

List Labels · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `acuityscheduling_me_get`

Get Account · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `acuityscheduling_order_get`

Get Order · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Numeric ID of the order. Get it from List Orders. Example: 1234.

Example input: `{"order_id":1234}`

### `acuityscheduling_orders_list`

List Orders · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `max` (`integer`, optional): Maximum number of results to return. Acuity defaults to 100. Example: 50.

Example input: `{}`

### `acuityscheduling_products_list`

List Products · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deleted` (`boolean`, optional): Set true to list deleted products. Example: true.

Example input: `{}`

### `acuityscheduling_appointment_create`

Create Appointment · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `appointment_type_id` (`integer`, required): Numeric ID of the appointment type. Get it from List Appointment Types. Example: 1.
- `datetime` (`string`, required): 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.
- `email` (`string`, required): 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_name` (`string`, required): Client first name. Example: Bob.
- `last_name` (`string`, required): Client last name. Example: McTest.
- `addon_ids` (`array`, optional): Add-on IDs to include in the appointment. They must belong to the appointment type. Get IDs from List Appointment Add-ons. Example: [3].
- `admin` (`boolean`, optional): 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_id` (`integer`, optional): Calendar to book on. If omitted, Acuity picks an available calendar. Get IDs from List Calendars. Example: 2.
- `certificate` (`string`, optional): Package or coupon certificate code to apply. Example: ABC123.
- `fields` (`array`, optional): 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!"}].
- `labels` (`array`, optional): 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_email` (`boolean`, optional): Set true to skip the confirmation e-mail and SMS Acuity would otherwise send to the client for this change. Example: true.
- `notes` (`string`, optional): Appointment notes. Only settable when admin is true. Example: Prefers the window seat.
- `phone` (`string`, optional): Client phone number. May be required by the account's settings. Example: +15551234567.
- `sms_opt_in` (`boolean`, optional): Set true when the client has explicitly agreed to receive SMS messages. Applies only to appointment types with SMS reminders enabled. Example: true.
- `timezone` (`string`, optional): Client's IANA time zone. Example: America/New_York.

Example input: `{"appointment_type_id":1,"datetime":"<datetime>","email":"<email>","first_name":"<first_name>","last_name":"<last_name>"}`

### `acuityscheduling_appointment_reschedule`

Reschedule Appointment · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_id` (`integer`, required): Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
- `datetime` (`string`, required): New date and time, parsed in the business time zone. ISO 8601 is safest. Example: 2026-02-04T10:00:00-0800.
- `admin` (`boolean`, optional): 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_id` (`integer`, optional): Calendar to move the appointment to. If omitted, it stays on its current calendar. Example: 2.
- `no_email` (`boolean`, optional): Set true to skip the confirmation e-mail and SMS Acuity would otherwise send to the client for this change. Example: true.
- `timezone` (`string`, optional): Client's IANA time zone. Example: America/New_York.

Example input: `{"appointment_id":31991639,"datetime":"<datetime>"}`

### `acuityscheduling_appointment_update`

Update Appointment · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appointment_id` (`integer`, required): Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
- `admin` (`boolean`, optional): 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.
- `certificate` (`string`, optional): Package or coupon certificate code. Only settable when admin is true. Example: ABC123.
- `email` (`string`, optional): Client e-mail address. Example: bob.mctest@example.com.
- `fields` (`array`, optional): 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_name` (`string`, optional): Client first name. Cannot be removed. Example: Bob.
- `labels` (`array`, optional): 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_name` (`string`, optional): Client last name. Cannot be removed. Example: McTest.
- `notes` (`string`, optional): Appointment notes. Only settable when admin is true. Example: Prefers the window seat.
- `phone` (`string`, optional): Client phone number. Example: +15551234567.
- `sms_opt_in` (`boolean`, optional): Set true when the client has explicitly agreed to receive SMS messages. Applies only to appointment types with SMS reminders enabled. Example: true.

Example input: `{"appointment_id":31991639}`

### `acuityscheduling_block_create`

Create Blocked Time · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `calendar_id` (`integer`, required): Calendar to block. Get IDs from List Calendars. Example: 2.
- `end` (`string`, required): End of the blocked period. Example: 2026-02-03T13:00:00-0800.
- `start` (`string`, required): Start of the blocked period, parsed in the business time zone. ISO 8601 is safest. Example: 2026-02-03T12:00:00-0800.
- `notes` (`string`, optional): Notes for the blocked period. Example: Lunch.

Example input: `{"calendar_id":2,"end":"<end>","start":"<start>"}`

### `acuityscheduling_client_create`

Create Client · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `first_name` (`string`, required): Client first name. Example: Bob.
- `last_name` (`string`, required): Client last name. Example: McTest.
- `email` (`string`, optional): Client e-mail address. Example: bob.mctest@example.com.
- `notes` (`string`, optional): Notes about the client. Example: Referred by Jane.
- `phone` (`string`, optional): Client phone number. Example: +15551234567.

Example input: `{"first_name":"<first_name>","last_name":"<last_name>"}`

### `acuityscheduling_client_update`

Update Client · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `first_name` (`string`, required): Client first name to save. Example: Bob.
- `last_name` (`string`, required): Client last name to save. Example: McTest.
- `lookup_first_name` (`string`, required): Current first name of the client to update. Example: Bob.
- `lookup_last_name` (`string`, required): Current last name of the client to update. Example: McTest.
- `email` (`string`, optional): Client e-mail address to save. Example: bob.mctest@example.com.
- `lookup_phone` (`string`, optional): Current phone number, to tell apart clients with the same name. Example: +15551234567.
- `notes` (`string`, optional): Notes to save on the client. Example: Prefers mornings.
- `phone` (`string`, optional): Client phone number to save. Example: +15551234567.

Example input: `{"first_name":"<first_name>","last_name":"<last_name>","lookup_first_name":"<lookup_first_name>","lookup_last_name":"<lookup_last_name>"}`

### `acuityscheduling_appointment_cancel`

Cancel Appointment · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `appointment_id` (`integer`, required): Numeric ID of the appointment. Get it from List Appointments. Example: 31991639.
- `admin` (`boolean`, optional): 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_note` (`string`, optional): Message included in the cancellation notification. Example: The office is closed that day.
- `no_email` (`boolean`, optional): Set true to skip the confirmation e-mail and SMS Acuity would otherwise send to the client for this change. Example: true.
- `no_show` (`boolean`, optional): Set true to mark the appointment as a no-show. Only settable when admin is true. Example: true.

Example input: `{"appointment_id":31991639}`

### `acuityscheduling_block_delete`

Delete Blocked Time · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `block_id` (`integer`, required): Numeric ID of the blocked time to delete. Example: 1234.

Example input: `{"block_id":1234}`

### `acuityscheduling_client_delete`

Delete Client · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `first_name` (`string`, required): Client first name of the client to delete. Example: Bob.
- `last_name` (`string`, required): Client last name of the client to delete. Example: McTest.
- `phone` (`string`, optional): Client phone number of the client to delete, to tell apart clients with the same name. Example: +15551234567.

Example input: `{"first_name":"<first_name>","last_name":"<last_name>"}`

## Related

Other Calendar connectors ([all 25](/agentkit/connectors/?category=calendar)):

- [Google Calendar](/agentkit/connectors/googlecalendar/): Scalekit connector, OAuth, 30 tools
- [Zoom](/agentkit/connectors/zoom/): Scalekit connector, OAuth, 58 tools
- [Calendly](/agentkit/connectors/calendly/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
