Skip to main content
Appointo logo
  • Category: scheduling & booking
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: APPOINTO
  • Version: 20261101_00

Tools

Slug: APPOINTO_AUTHENTICATETool to authenticate with the Appointo API by validating the APPOINTO-TOKEN header. Use when verifying the token before subsequent API calls.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_CANCEL_BOOKINGCancel an Appointo booking or cancel selected customers from it. Omit customer IDs to cancel the whole booking. Appointo limits cancellation requests to 100 per day.

Input Parameters

integer
required
Booking ID to cancel
array
Array of customer IDs to cancel; omit to cancel entire booking

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_CREATE_BOOKINGCreate a customer booking for an appointment and timeslot. An unauthorized response is returned as an empty bookings list; the provider documents a maximum of 100 creation requests per day.

Input Parameters

string
required
Name of the customer.
string
required
Email of the customer.
string
Phone number of the customer.
integer
Number of bookings (default is 1).
string
required
ISO 8601 datetime string for the desired timeslot.
integer
required
Appointo Appointment Id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_GET_APPOINTMENT_AVAILABILITYFetch calendar availability for a specific Appointo appointment from a start date, optionally through an end date. Availability can be filtered to specified team members; dates use YYYY-MM-DD format.

Input Parameters

string
End date for availability range in YYYY-MM-DD format
string
required
Start date for availability range in YYYY-MM-DD format
integer
required
Appointment identifier
array
List of team member IDs to filter availability

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_LIST_APPOINTMENTSList Appointo appointments, optionally filtering by appointment ID or product ID. Results use offset pagination, with a default and maximum page size of 100.

Input Parameters

integer
Number of items per page (default and maximum is 100).
integer
Pagination offset, zero-based index (default is 0).
integer
Filter to fetch appointments for a specific product by its ID.
integer
Filter to fetch a single appointment by its ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_LIST_BOOKINGSList Appointo bookings or retrieve a booking by ID. Filter by past or upcoming status or search by product, customer, email, phone, or order name. Use limit and offset for pagination; the maximum page size is 100.

Input Parameters

integer
Maximum number of bookings to return (1-100).
integer
Number of bookings to skip for pagination.
string ("past" | "upcoming")
Filter bookings by status: ‘past’ or ‘upcoming’.
integer
Fetch a single booking by its ID.
string
Search bookings by product name, customer name, email, phone, or order name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_LIST_PRODUCTSList products added in Appointo, optionally filtering by product name. Use limit and offset to browse pages; the default and maximum page size is 100.

Input Parameters

integer
Maximum number of products to return (max 100; default server-side is 100)
string
Pagination offset token returned by a previous call
string
Filter products by name (case-insensitive substring match)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_LIST_SUBSCRIPTION_CONTRACTSList Appointo subscription contracts, optionally searching by product name, variant name, order number, or customer name. Use limit and offset to request a page; the action accepts a maximum limit of 100.

Input Parameters

integer
Maximum number of subscription contracts to return per page (default and maximum is 100).
integer
Pagination offset, zero-based index (default is 0).
string
Search by product name, variant name, order number, or customer name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_RESCHEDULE_BOOKINGReschedule an entire booking or selected customers to a new timeslot, optionally forcing the reschedule. An unauthorized response returns an unauthorized status and a placeholder booking.

Input Parameters

boolean
Force reschedule even if the timeslot is occupied.
integer
required
Booking ID to reschedule.
string
required
New timeslot timestamp in ISO 8601 format.
array
List of customer IDs to reschedule; if omitted, the entire booking is rescheduled.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_UPDATE_BOOKINGUpdate buffer times for an existing booking. An unauthorized response returns an unauthorized status and a placeholder booking rather than updated booking data.

Input Parameters

integer
required
Booking ID to update
integer
End buffer time in minutes, must be greater than 0
integer
Start buffer time in minutes, must be greater than 0

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: APPOINTO_UPSERT_APPOINTMENT_CONFIGCreate or update an Appointo appointment’s configuration, weekly availability, and date-specific overrides. Use this to set the appointment’s scheduling and availability settings.

Input Parameters

object
required
Appointment configuration settings
array
required
Date-specific overrides
integer
required
ID of the appointment to configure
array
required
Weekly availability definitions

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not