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
- API key
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 Appointo connection
In AgentKit > Connections, create an Appointo connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'appointo'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'appointo_appointments_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "appointo"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="appointo_appointments_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolappointo_appointment_availability_getGet the open time slots of an appointment type for a date range.Read-onlyGet 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-onlyList 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-onlyList 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-onlyList 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-onlyList 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-onlyList 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.WriteUpdate 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).WriteCreate 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.
appointo_booking_rescheduleMove a booking, or some of its customers, to another time slot (limited to 100 calls per day).WriteReschedule Booking
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.
- Idempotent
Inputs
booking_idintegerrequired- Booking ID to reschedule, from appointo_bookings_list. Example: 969.
timestringstringrequired- New slot start, ISO 8601. Example: 2026-11-21T15:00:00Z.
customer_idsarray- 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]
overrideboolean- true forces the reschedule into the slot. Defaults to false. Example: false.
appointo_booking_updateChange the buffer time before and after a booking (limited to 100 calls per day).WriteUpdate Booking Buffers
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.
- Idempotent
Inputs
booking_idintegerrequired- Booking ID, from appointo_bookings_list. Example: 969.
end_buffer_timeinteger- Buffer after the booking, in minutes (greater than 0). Example: 15.
start_buffer_timeinteger- Buffer before the booking, in minutes (greater than 0). Example: 15.
appointo_booking_cancelCancel a booking, or only some of its customers (limited to 100 calls per day).DestructiveCancel Booking
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.
- Idempotent
Inputs
booking_idintegerrequired- Booking ID to cancel, from appointo_bookings_list. Example: 969.
customer_idsarray- 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]
No tools match.