Create appointment
create_appointmentBook a client for one or more services from a start time, with Booksy verifying each staff member's availability first so busy slots are refused instead of double-booked.
Instructions
Book a client for one or more services at a start time; Booksy checks the slots first.
Books one client card for service_id, or for several services in one appointment, each with its own staff member, back to back from start. Each end follows the service's duration. Booksy's dry run checks every staff member is free first; a busy slot is refused, never double-booked. The client gets Booksy's confirmation only with notify_client. dry_run returns the same answer with saved false and keeps nothing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"client_id": "<client_id>",
"start": "<start>"
},
"name": "create_appointment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Internal note, only staff see it. | |
| start | Yes | ISO 8601. Without a time zone it is the business's local time. | |
| dry_run | No | Only check the time and price; nothing is saved. Default: false. | |
| services | No | Services of the appointment in order, each starting when the one before ends. | |
| staff_id | No | Staff ID from list_staff, with service_id. Default: the first one who offers the service. | |
| client_id | Yes | Client ID from list_clients or add_client. | |
| service_id | No | service_id from list_services (its first variant), or a variant_id. Or use services. | |
| notify_client | No | Send Booksy's booking confirmation to the client. Default: false. |