book_appointment
Reserve an appointment slot at a service business. Provide a unique idempotency_key to safely retry without double-booking. Get service_id from get_business and start_time/end_time from get_availability.
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": {
"business_slug": "<business_slug>",
"service_id": "<service_id>",
"start_time": "<start_time>",
"end_time": "<end_time>",
"customer_name": "<customer_name>",
"customer_email": "<customer_email>",
"idempotency_key": "<idempotency_key>"
},
"name": "book_appointment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Any special requests or notes for the business | |
| end_time | Yes | ISO 8601 datetime for the appointment end (from get_availability) | |
| staff_id | No | Staff member ID (from get_business). Omit to auto-assign. | |
| service_id | Yes | The service ID from get_business results | |
| start_time | Yes | ISO 8601 datetime for the appointment start (from get_availability) | |
| business_slug | Yes | The business slug from search_businesses results | |
| customer_name | Yes | Customer full name | |
| customer_email | Yes | Customer email address | |
| customer_phone | No | Customer phone number (optional) | |
| idempotency_key | Yes | Unique key to prevent duplicate bookings (e.g. UUID). Reuse the same key to safely retry. |