Create a new calendar event with title, dates, and optional details like location, time, and notifications. DATE RULE: The API server uses UTC. Today's date may be rejected as "past" depending on the user's local timezone. To be safe, always use tomorrow's date or later when creating events. NEVER use today's date — it will fail with "Cannot Create Events In The Past". If the user asks to create an event for today, explain this limitation and suggest tomorrow instead.
# create_calendar_event
## When to use
Create a new calendar event with title, dates, and optional details like location, time, and notifications. DATE RULE: The API server uses UTC. Today's date may be rejected as "past" depending on the user's local timezone. To be safe, always use tomorrow's date or later when creating events. NEVER use today's date — it will fail with "Cannot Create Events In The Past". If the user asks to create an event for today, explain this limitation and suggest tomorrow instead.
## Parameters to validate before calling
- title (string, required) — Event title (required)
- start_date (string, required) — Start date in ISO 8601 format, e.g., 2026-01-20 (required)
- end_date (string, required) — End date in ISO 8601 format, e.g., 2026-01-20 (required)
- description (string, optional) — Event description (optional)
- location (string, optional) — Event location (optional)
- start_time (string, optional) — Start time in HH:MM format, e.g., 09:00 (optional)
- end_time (string, optional) — End time in HH:MM format, e.g., 17:00 (optional)
- color (string, optional) — Event color in hex format, e.g., #FF5733 (optional)
- all_day (boolean, optional) — Whether this is an all-day event (optional, default: false)
- status (string, optional) — Event status (optional)
- private_event (boolean, optional) — Whether this is a private event (optional, default: false)
- sms_notification (boolean, optional) — Enable SMS notifications (optional, default: false)
- completed (boolean, optional) — Mark event as completed (optional, default: false)
- latitude (number, optional) — Location latitude coordinate (optional)
- longitude (number, optional) — Location longitude coordinate (optional)
- event_url (string, optional) — URL associated with the event (optional)
- people_involved (string, optional) — People involved in the event (optional)
- repeat_this_event (string, optional) — Repeat configuration for recurring events (optional)
- notification (string, optional) — Notification settings (optional)
## Notes
- Calendar API uses UTC — today's date may be rejected as past depending on the user's timezone
- Always use tomorrow or later when creating events
- If the user asks for today, explain the UTC limitation
Connector