Update appointment
Edit client name, phone, email, notes or label on an appointment.
MCP tool acuity_scheduling_write → update_appointment
write Confirm
Changes the fields you pass on one appointment and leaves the rest. Only these can change: first and last name (never blank), phone, email, notes, one label, and intake form fields. It does not move or cancel the booking. Use reschedule_appointment or cancel_appointment for that. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| appointment_id integer required | integer | Appointment ID from list_appointments. |
| first_name string | string | New first name. Cannot be empty. |
| last_name string | string | New last name. Cannot be empty. |
| phone string | string | New phone. |
| email string | string | New email. |
| notes string | string | Replaces the appointment notes. |
| label string | string | Label name. An appointment holds one label. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "acuity_scheduling_write",
"arguments": {
"operation": "update_appointment",
"arguments": {
"appointment_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"appointment_id": 1840211,
"first_name": "Ana",
"last_name": "Lopez",
"notes": "Bring last report",
"label": "Returning",
"datetime": "2026-11-05T09:30:00-0500"
},
"isError": false
}