createAppointment
Schedule an appointment with start and end times, optional type, location, description, and invitees; optionally send email or SMS invitations to users or contacts.
Instructions
Create an appointment. Use start/end (UTC; offset suffix allowed), typeId/outcomeId, invitees [{userId}] or [{personId}]. sendInvitation=true emails invitees (SMS too if reminders are on); default false.
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": {
"title": "<title>",
"start": "<start>",
"end": "<end>"
},
"name": "createAppointment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | End, ISO 8601 UTC or with offset | |
| start | Yes | Start, ISO 8601 UTC or with offset | |
| title | Yes | Appointment title | |
| allDay | No | All-day event. Default false | |
| typeId | No | Appointment type ID (see listAppointmentTypes) | |
| invitees | No | People/users to invite: [{userId}] for a user, [{personId}] for a contact (optional name, email). | |
| location | No | Location or address | |
| outcomeId | No | Appointment outcome ID (see listAppointmentOutcomes) | |
| createdById | No | Creator user ID; admins only | |
| description | No | Description | |
| sendInvitation | No | Query param: email invitees. Default false |