NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Appointo connects to a Nagent workspace with an API key. Once it is connected, agents can call 11 Appointo actions, such as "Create Booking", "Get Appointment Availability" and "List Appointments". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Appointo, with input parameters and output schema.
APPOINTO_AUTHENTICATETool to authenticate with the Appointo API by validating the APPOINTO-TOKEN header. Use when verifying the token before subsequent API calls.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_CANCEL_BOOKINGTool to cancel a booking or selected customers. Use when you need to revoke an entire booking or individual attendees after verifying booking details. Use after retrieving booking information.
Input parameters
Booking ID to cancel
Array of customer IDs to cancel; omit to cancel entire booking
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_CREATE_BOOKINGTool to create a new booking. Use when scheduling a customer booking after confirming appointment availability.
Input parameters
Name of the customer.
Email of the customer.
Phone number of the customer.
Number of bookings (default is 1).
ISO 8601 datetime string for the desired timeslot.
Appointo Appointment Id.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_GET_APPOINTMENT_AVAILABILITYTool to get calendar availability for a specific appointment. Use when you need to fetch available time slots for an appointment within a date range.
Input parameters
End date for availability range in YYYY-MM-DD format
Start date for availability range in YYYY-MM-DD format
Appointment identifier
List of team member IDs to filter availability
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_LIST_APPOINTMENTSTool to list appointments. Use when fetching appointments with optional filters and pagination after confirming a valid API token.
Input parameters
Number of items per page (default and maximum is 100).
Pagination offset, zero-based index (default is 0).
Filter to fetch appointments for a specific product by its ID.
Filter to fetch a single appointment by its ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_LIST_BOOKINGSTool to list bookings. Use when you need to fetch bookings filtered by status, paging, or search term.
Input parameters
Maximum number of bookings to return (1-100).
Number of bookings to skip for pagination.
Filter bookings by status: 'past' or 'upcoming'.
Fetch a single booking by its ID.
Search bookings by product name, customer name, email, phone, or order name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_LIST_PRODUCTSTool to fetch all available products. Use when browsing products with optional paging and search. Call after authenticating with Appointo API.
Input parameters
Maximum number of products to return (max 100; default server-side is 100)
Pagination offset token returned by a previous call
Filter products by name (case-insensitive substring match)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_LIST_SUBSCRIPTION_CONTRACTSTool to list subscription contracts. Use when retrieving contracts with optional search after confirming a valid API token.
Input parameters
Maximum number of subscription contracts to return per page (default and maximum is 100).
Pagination offset, zero-based index (default is 0).
Search by product name, variant name, order number, or customer name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_RESCHEDULE_BOOKINGTool to reschedule an existing booking to a new timeslot. Use after confirming new timeslot availability.
Input parameters
Force reschedule even if the timeslot is occupied.
Booking ID to reschedule.
New timeslot timestamp in ISO 8601 format.
List of customer IDs to reschedule; if omitted, the entire booking is rescheduled.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_UPDATE_BOOKINGTool to update buffer times for an existing booking. Use after confirming new buffer durations.
Input parameters
Booking ID to update
End buffer time in minutes, must be greater than 0
Start buffer time in minutes, must be greater than 0
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
APPOINTO_UPSERT_APPOINTMENT_CONFIGTool to upsert availability config for an appointment. Use when setting or updating appointment availability settings.
Input parameters
Appointment configuration settings
Date-specific overrides
ID of the appointment to configure
Weekly availability definitions
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 11 Appointo actions on Nagent, including "Create Booking", "Get Appointment Availability" and "List Appointments". Create Booking: Create a new booking. Each action is listed on this page with its input parameters and its output.
Appointo connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Booking takes 4 required inputs: name, email, timestring and appointment_id. It also takes 2 optional inputs: phone and quantity. It returns data, error and successful.