create_event
Schedule bookings, appointments, or meetings on a calendar. Use hold status to tentatively reserve slots that auto-release after a set time.
Instructions
Create a booking, appointment, meeting, hold, or any scheduled event on a calendar. The calendar_id comes from create_calendar or list_events. Once created, this event blocks the agent's availability during that time and appears in availability queries. Use status="hold" with hold_expires_at to tentatively reserve a slot that auto-releases on TTL.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Event title | |
| status | No | Event status. "hold" creates a tentative reservation that auto-expires at hold_expires_at. Defaults to "confirmed". | |
| all_day | No | Whether this is an all-day event | |
| end_time | Yes | End time (ISO 8601) | |
| reminders | No | Reminder offsets in minutes before start_time (e.g. [10, 1440]). Each fires an event.reminder webhook and shows as an alarm in the iCal feed. Omit or null to inherit the calendar default (then the system default of 10 min); [] for no reminders. | |
| start_time | Yes | Start time (ISO 8601) | |
| calendar_id | Yes | Calendar ID to add the event to | |
| description | No | Optional event description | |
| hold_priority | No | Only valid with status="hold". Higher-priority overlapping holds pre-empt lower-priority ones. Defaults to 0. | |
| hold_expires_at | No | Required when status="hold". ISO 8601 timestamp 30s-15min in the future. Auto-releases the hold when reached. |