Send a new calendar invitation
create_eventCreate a meeting and send calendar invitations to the attendees (all on allow_send_to); it appears in Outlook, Gmail and Apple Calendar.
Instructions
Create a meeting and send calendar invitations to the attendees (all on allow_send_to); it appears in Outlook, Gmail and Apple Calendar. Remember the returned id: to change or cancel the meeting use update_event or cancel_event, never create a second one. Times without offset are read in timezone or the mailbox time zone; for all-day events (holidays, absences) set all_day and give dates, and show_as free keeps calendars free; the invitation is reviewed and counts towards the send limit. Returns the event with id, UTC and local times.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End, same format as start and after it; for all_day the last day (inclusive, defaults to start) | |
| start | Yes | Start, e.g. 2026-10-05T14:00 (mailbox time zone) or with offset/Z; for all_day a date like 2026-10-05 | |
| title | Yes | Meeting title shown in calendars | |
| all_day | No | true: all-day event over whole days; start and end are dates. Default false | |
| show_as | No | How the time shows in attendees' calendars: busy (default), free, tentative or oof (out of office) | |
| location | No | Place or meeting link | |
| timezone | No | IANA zone for times without offset; defaults to the mailbox timezone | |
| attendees | Yes | Email addresses to invite; each must be on allow_send_to | |
| description_markdown | No | Agenda or notes in Markdown |