> **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 Appointo

The Appointo connector lets your AI agent act in each user's Appointo account. Each user connects their own Appointo API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 11 tools.

**Authentication:** API Key
**Categories:** Calendar, Productivity
**Tools:** 11: 6 read, 4 write, 1 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=APPOINTO)

## 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 Appointo connection

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

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'appointo'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Appointo:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'appointo_appointments_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "appointo"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Appointo:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="appointo_appointments_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Appointo credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## 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: 'appointo_appointment_availability_get',
  toolInput: {
    appointment_id: 299,
    start_date: '<start_date>',
  },
  connector: 'appointo',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="appointo_appointment_availability_get",
    tool_input={
        "appointment_id": 299,
        "start_date": "<start_date>",
    },
    connection_name="appointo",
    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.

### `appointo_appointment_availability_get`

Get Appointment Availability · Read-only

Get the open time slots of an appointment type for a date range.
Returns the available days and slots.
Use this before appointo_booking_create to pick a timestring.

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

Inputs:

- `appointment_id` (`integer`, required): Appointment ID, from appointo_appointments_list. Example: 299.
- `start_date` (`string`, required): First date to check (YYYY-MM-DD). Example: 2026-11-20.
- `end_date` (`string`, optional): Last date to check (YYYY-MM-DD). Example: 2026-11-27.
- `impersonated_tms` (`string`, optional): Only show availability for these team member IDs, as a JSON-style list. Example: [123, 234]

Example input: `{"appointment_id":299,"start_date":"<start_date>"}`

### `appointo_appointments_list`

List Appointments · Read-only

List appointment types (bookable services) with their settings, optionally for one product or one appointment ID.
Returns each appointment's id, product, duration, capacity, availability and configuration.
Use this to find an appointment ID for appointo_booking_create or appointo_appointment_availability_get.

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

Inputs:

- `appointment_id` (`integer`, optional): Return only this appointment. Example: 299.
- `limit` (`integer`, optional): Maximum number of results, up to 100 (the default). Example: 50.
- `offset` (`integer`, optional): Number of results to skip, for paging. Defaults to 0. Example: 0.
- `product_id` (`integer`, optional): Only appointments for this product ID. Example: 7012345678901.
- `search_term` (`string`, optional): Filter by text. Example: Haircut.

Example input: `{}`

### `appointo_bookings_cancelled_list`

List Cancelled Bookings · Read-only

List cancelled bookings, optionally past or upcoming or matching search text.
Returns each cancelled booking with its time, product and customers.
Use appointo_bookings_list for active bookings.

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

Inputs:

- `limit` (`integer`, optional): Maximum number of results, up to 100 (the default). Example: 50.
- `offset` (`integer`, optional): Number of results to skip, for paging. Defaults to 0. Example: 0.
- `search_term` (`string`, optional): Search across product name, customer name, email, phone and order name. Example: jane@example.com.
- `status` (`string`, optional): past or upcoming. Leave empty for both. Example: past. One of: `past`, `upcoming`.

Example input: `{}`

### `appointo_bookings_list`

List Bookings · Read-only

List bookings, filtered to past or upcoming, by search text, or one booking by ID.
Returns each booking's id, time, product and variant, duration, quantity, customers (with customer IDs) and order details.
Use this to find a booking ID. Use appointo_bookings_cancelled_list for cancelled bookings.

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

Inputs:

- `booking_id` (`integer`, optional): Return only this booking. Example: 969.
- `limit` (`integer`, optional): Maximum number of results, up to 100 (the default). Example: 50.
- `offset` (`integer`, optional): Number of results to skip, for paging. Defaults to 0. Example: 0.
- `search_term` (`string`, optional): Search across product name, customer name, email, phone and order name. Example: jane@example.com.
- `status` (`string`, optional): past or upcoming. Leave empty for both. Example: upcoming. One of: `past`, `upcoming`.

Example input: `{}`

### `appointo_products_list`

List Products · Read-only

List the Shopify products set up as bookable in Appointo.
Returns each product's id, name and its appointments with their IDs.
Use this to find appointment IDs by product. Use appointo_appointments_list for appointment settings.

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

Inputs:

- `limit` (`integer`, optional): Maximum number of results, up to 100 (the default). Example: 50.
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 0.
- `search_term` (`string`, optional): Filter by product name. Example: Haircut.

Example input: `{}`

### `appointo_subscription_contracts_list`

List Subscription Contracts · Read-only

List appointment subscription contracts (recurring booking plans), optionally matching a search term.
Returns each contract's id, product, variant, customer, order and schedule details.

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

Inputs:

- `search_term` (`string`, optional): Search by product name, variant name, order number or customer name. Example: Jane Doe.

Example input: `{}`

### `appointo_appointment_config_upsert`

Update Appointment Configuration · Write

Update an appointment type's settings, weekly availability and date overrides.
Returns the saved configuration.
Read the current settings with appointo_appointments_list first; send all date overrides you want to keep, because the list you send replaces them.

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

Inputs:

- `appointment_id` (`integer`, required): Appointment ID, from appointo_appointments_list. Example: 299.
- `availabilities` (`array`, optional): Weekly availability, one object per weekday with weekday (monday...sunday), weekday_index (0 Sunday to 6 Saturday), day_available and slots (start_time and end_time like 09:00AM). Include the existing id to update a day. Example: [{"weekday": "monday", "weekday_index": 1, "day_available": true, "slots": [{"start_time": "09:00AM", "end_time": "05:00PM"}]}]
- `config` (`object`, optional): Settings to change, such as timezone, duration, interval, minimum_notice and max_capacity (minutes and counts as strings), buffers, reminders, allow_cancel, allow_reschedule and date range options. Example keys follow the Appointo API reference. Example: {"timezone": "America/New_York", "duration": "30", "interval": "30", "max_capacity": "1"}
- `override` (`array`, optional): Date overrides, each with day (YYYY-MM-DD), day_available and slots. Send every override to keep; include the existing id to update one. Example: [{"day": "2026-12-24", "day_available": false, "slots": []}]

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

### `appointo_booking_create`

Create Booking · Write

Book a time slot of an appointment type for a customer (limited to 100 calls per day).
Returns the created booking with its id, time, product and customers.
Get the appointment ID from appointo_appointments_list and a free slot from appointo_appointment_availability_get.

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

Inputs:

- `appointment_id` (`integer`, required): Appointment ID to book. Example: 299.
- `email` (`string`, required): Customer's email. Example: jane@example.com.
- `name` (`string`, required): Customer's name. Example: Jane Doe.
- `timestring` (`string`, required): Start of the time slot, ISO 8601. Example: 2026-11-20T15:00:00Z.
- `phone` (`string`, optional): Customer's phone number. Example: +14155550123.
- `quantity` (`integer`, optional): Number of spots to book. Defaults to 1. Example: 1.

Example input: `{"appointment_id":299,"email":"<email>","name":"<name>","timestring":"<timestring>"}`

### `appointo_booking_reschedule`

Reschedule Booking · Write

Move a booking, or some of its customers, to another time slot (limited to 100 calls per day).
Returns status ok and the updated booking.
Set override=true to force the slot even if it looks unavailable.

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

Inputs:

- `booking_id` (`integer`, required): Booking ID to reschedule, from appointo_bookings_list. Example: 969.
- `timestring` (`string`, required): New slot start, ISO 8601. Example: 2026-11-21T15:00:00Z.
- `customer_ids` (`array`, optional): Only these customers of a group booking (customer IDs from the booking's customers list). Leave empty to apply to the whole booking. Example: [1095]
- `override` (`boolean`, optional): true forces the reschedule into the slot. Defaults to false. Example: false.

Example input: `{"booking_id":969,"timestring":"<timestring>"}`

### `appointo_booking_update`

Update Booking Buffers · Write

Change the buffer time before and after a booking (limited to 100 calls per day).
Returns status ok and the booking.
Use appointo_booking_reschedule to change the time.

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

Inputs:

- `booking_id` (`integer`, required): Booking ID, from appointo_bookings_list. Example: 969.
- `end_buffer_time` (`integer`, optional): Buffer after the booking, in minutes (greater than 0). Example: 15.
- `start_buffer_time` (`integer`, optional): Buffer before the booking, in minutes (greater than 0). Example: 15.

Example input: `{"booking_id":969}`

### `appointo_booking_cancel`

Cancel Booking · Destructive

Cancel a booking, or only some of its customers (limited to 100 calls per day).
Returns status ok and the booking.
Cancelled bookings appear in appointo_bookings_cancelled_list.

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

Inputs:

- `booking_id` (`integer`, required): Booking ID to cancel, from appointo_bookings_list. Example: 969.
- `customer_ids` (`array`, optional): Only these customers of a group booking (customer IDs from the booking's customers list). Leave empty to apply to the whole booking. Example: [1095]

Example input: `{"booking_id":969}`

## 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 |
