create_event
Create a new event in a TimeTree calendar. Supports labels, recurrences, attendees, alerts, and checklists. Requires calendar ID, title, and start/end times.
Instructions
Create a new event in a TimeTree calendar. Requires CSRF token (automatically managed). Returns the created event with UUID. Label colors (label_id 1-10): 1=Emerald green, 2=Modern cyan, 3=Deep sky blue, 4=Pastel brown, 5=Midnight black, 6=Apple red, 7=French rose, 8=Coral pink, 9=Bright orange, 10=Soft violet. Supports checklist, attendees, virtual attendees, alerts, RRULE recurrence strings, and category override.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| calendar_id | Yes | The calendar ID to create the event in (use list_calendars to get valid IDs) | |
| title | Yes | Event title (required) | |
| all_day | No | Whether this is an all-day event (default: false). TimeTree uses inclusive end dates for all-day events. | |
| start_at | Yes | Event start time as Unix timestamp in milliseconds. For all-day events, use midnight of the start date. | |
| start_timezone | No | Start timezone (default: UTC). Examples: "Asia/Seoul", "America/New_York" | |
| end_at | Yes | Event end time as Unix timestamp in milliseconds. For all-day events, TimeTree uses an inclusive end date. | |
| end_timezone | No | End timezone (default: UTC) | |
| label_id | No | Color label ID (1-10). 1=Emerald, 2=Cyan, 3=Blue, 4=Brown, 5=Black, 6=Red, 7=Rose, 8=Pink, 9=Orange, 10=Violet | |
| category | No | Event category (default: 1; memos use category=2) | |
| note | No | Event notes/description | |
| location | No | Event location | |
| url | No | Related URL | |
| attendees | No | Calendar user IDs attending this event | |
| recurrences | No | RRULE strings, e.g. ["RRULE:FREQ=DAILY;COUNT=2"] | |
| alerts | No | Notification offsets in minutes before the event, e.g. [5, 30] | |
| file_uuids | No | Attached file UUIDs if already uploaded | |
| checklist | No | Checklist items to attach to the event | |
| virtual_user_attendees | No | Virtual member IDs/names attending this event |