Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Appointo

Scalekit connector
Open markdown

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.

Tools
11
What they doRead · write · destructive
6 · 4 · 16 read4 write1 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  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.

  4. Authorize a user and make your first call

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Appointo credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • appointo_appointment_availability_getGet the open time slots of an appointment type for a date range.Read-only

    Get Appointment Availability

    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.

    Inputs

    appointment_idintegerrequired
    Appointment ID, from appointo_appointments_list. Example: 299.
    start_datestringrequired
    First date to check (YYYY-MM-DD). Example: 2026-11-20.
    end_datestring
    Last date to check (YYYY-MM-DD). Example: 2026-11-27.
    impersonated_tmsstring
    Only show availability for these team member IDs, as a JSON-style list. Example: [123, 234]
  • appointo_appointments_listList appointment types (bookable services) with their settings, optionally for one product or one appointment ID.Read-only

    List Appointments

    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.

    Inputs

    appointment_idinteger
    Return only this appointment. Example: 299.
    limitinteger
    Maximum number of results, up to 100 (the default). Example: 50.
    offsetinteger
    Number of results to skip, for paging. Defaults to 0. Example: 0.
    product_idinteger
    Only appointments for this product ID. Example: 7012345678901.
    search_termstring
    Filter by text. Example: Haircut.
  • appointo_bookings_cancelled_listList cancelled bookings, optionally past or upcoming or matching search text.Read-only

    List Cancelled Bookings

    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.

    Inputs

    limitinteger
    Maximum number of results, up to 100 (the default). Example: 50.
    offsetinteger
    Number of results to skip, for paging. Defaults to 0. Example: 0.
    search_termstring
    Search across product name, customer name, email, phone and order name. Example: jane@example.com.
    statusstring
    past or upcoming. Leave empty for both. Example: past.one of pastupcoming
  • appointo_bookings_listList bookings, filtered to past or upcoming, by search text, or one booking by ID.Read-only

    List Bookings

    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.

    Inputs

    booking_idinteger
    Return only this booking. Example: 969.
    limitinteger
    Maximum number of results, up to 100 (the default). Example: 50.
    offsetinteger
    Number of results to skip, for paging. Defaults to 0. Example: 0.
    search_termstring
    Search across product name, customer name, email, phone and order name. Example: jane@example.com.
    statusstring
    past or upcoming. Leave empty for both. Example: upcoming.one of pastupcoming
  • appointo_products_listList the Shopify products set up as bookable in Appointo.Read-only

    List Products

    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.

    Inputs

    limitinteger
    Maximum number of results, up to 100 (the default). Example: 50.
    offsetinteger
    Number of results to skip, for paging. Example: 0.
    search_termstring
    Filter by product name. Example: Haircut.
  • appointo_subscription_contracts_listList appointment subscription contracts (recurring booking plans), optionally matching a search term.Read-only

    List Subscription Contracts

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

    Inputs

    search_termstring
    Search by product name, variant name, order number or customer name. Example: Jane Doe.
  • appointo_appointment_config_upsertUpdate an appointment type's settings, weekly availability and date overrides.Write

    Update Appointment Configuration

    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.

    • Idempotent

    Inputs

    appointment_idintegerrequired
    Appointment ID, from appointo_appointments_list. Example: 299.
    availabilitiesarray
    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"}]}]
    configobject
    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"}
    overridearray
    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": []}]
  • appointo_booking_createBook a time slot of an appointment type for a customer (limited to 100 calls per day).Write

    Create Booking

    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.

    Inputs

    appointment_idintegerrequired
    Appointment ID to book. Example: 299.
    emailstringrequired
    Customer's email. Example: jane@example.com.
    namestringrequired
    Customer's name. Example: Jane Doe.
    timestringstringrequired
    Start of the time slot, ISO 8601. Example: 2026-11-20T15:00:00Z.
    phonestring
    Customer's phone number. Example: +14155550123.
    quantityinteger
    Number of spots to book. Defaults to 1. Example: 1.