Add appointment
Adds an appointment to the agenda the way you do for a client who books by phone.
MCP tool planity_write → create_appointment
write Confirm
Returns the new appointment as the agenda shows it. The end time follows the duration of the service. The help article on adding an appointment does not say whether Planity notifies the client, so the agent reports what Planity shows after saving. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| service_id string required | string | Id from list_services. |
| staff_id string required | string | Id from list_staff. |
| start string required | string | Date and start time, ISO 8601, in the salon's local time. |
| client_id string | string | Existing client from list_clients. Leave out to enter a new client with client_name. |
| client_name string | string | Name of a client without a record. Required when client_id is left out. |
| client_phone string | string | Phone of a client without a record. |
| notes string | string | Note on the appointment. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "planity_write",
"arguments": {
"operation": "create_appointment",
"arguments": {
"service_id": "sv_11",
"staff_id": "st_01",
"start": "2026-10-27T15:00:00",
"client_id": "c_1042"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"appointment_id": "a_9201",
"start": "2026-10-27T15:00:00",
"end": "2026-10-27T16:00:00",
"client": {
"client_id": "c_1042",
"name": "Léa Martin"
},
"service": "Coupe femme",
"staff": {
"staff_id": "st_01",
"name": "Amélie"
},
"status": "confirmed",
"source": "salon"
},
"isError": false
}