create_block
Create Time Block
Block off a time range on a specific calendar to prevent appointment scheduling during that period.
create_block
Block off a time range on a specific calendar to prevent appointment scheduling during that period.
list_blocks
Retrieve a list of time blocks. Optionally filter by date range or calendar.
list_clients
Search and retrieve client records. Filter by name, email, or phone number, or use a general search query.
check_availability
Check available dates for a given month or available time slots for a specific date. Provide a **month** to get available dates, or a **date** to get specific time slots. Both require an appointment type ID.
create_appointment
Book a new appointment. Requires the appointment datetime, appointment type, and client details. Optionally provide a calendar, custom intake form field values, add-ons, and coupon/certificate codes.
create_client
Create a new client record with contact information.
delete_client
Permanently delete a client record.
update_appointment
Update an existing appointment's client details, notes, or intake form field values. To change the appointment time, use the Reschedule Appointment tool instead.
get_appointment
Retrieve full details of a specific appointment by ID, including client info, intake form responses, and payment status.
check_certificate
Validate a certificate or coupon code. Optionally check against a specific appointment type to verify eligibility.
list_appointment_types
Retrieve all configured appointment types (service offerings) including their duration, pricing, and associated calendars. Also returns available add-ons.
list_orders
Retrieve all orders for packages, gift certificates, and subscriptions.
list_forms
Retrieve all intake form definitions configured for the account. Forms are associated with appointment types and collect custom information from clients during booking. Use field IDs when creating or updating appointments with custom field values.
get_account
Retrieve information about the authenticated Acuity Scheduling account, including the account owner name, email, and timezone.
reschedule_appointment
Reschedule an existing appointment to a new date and time. Optionally change the calendar. The new datetime must be an available slot.
cancel_appointment
Cancel a scheduled appointment. Optionally include a cancellation note and suppress the cancellation email notification.
update_client
Update an existing client's contact information or notes.
delete_certificate
Delete a certificate by ID.
list_labels
Retrieve all labels used for categorizing and organizing appointments.
delete_block
Remove a time block to re-open that time slot for scheduling.
create_certificate
Create a certificate code for a package or coupon. Provide either a product ID (for packages) or a coupon ID (for coupons). Optionally specify a custom certificate code and assign it to an email.
list_products
Retrieve all products and packages available in the online store.
get_appointment_payments
Retrieve payment information for a specific appointment.
list_appointments
Retrieve a list of scheduled appointments. Filter by date range, calendar, appointment type, client name, email, or phone. Returns up to 100 appointments per request.
list_calendars
Retrieve all calendars (staff members or locations) configured in the account. Use calendar IDs when creating appointments or checking availability.
Create, retrieve, update, cancel, and reschedule appointments. Manage availability by querying open dates and time slots for appointment types and calendars. Block time slots to prevent bookings. Manage client records including creation, retrieval, updates, and deletion. List appointment types, add-ons, calendars, and intake forms. Create and validate gift certificates, packages, and coupons. Retrieve orders and product listings. Subscribe to webhooks for appointment and order events.
Common questions about connecting Acuity Scheduling to AI agents with Metorial.