Command
nylas calendar events create
Create a new calendar event with participants, location, and description.
Written by Qasim Muhammad Staff SRE
What does nylas calendar events create do?
The nylas calendar events create command adds a new event to your connected calendar. Specify --title, --start, and --end at minimum. Add repeatable --participant flags for attendees, --location for a physical or virtual location, and --description for the event body. Supports Google Calendar, Outlook, Exchange, Yahoo, iCloud, and IMAP providers.
Usage
nylas calendar events create --title TITLE --start START --end END [--participant EMAIL] [--location LOC] [--description DESC]Flags
| Flag | Description |
|---|---|
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
| --title | Event title |
| --start | Start time (ISO 8601) |
| --end | End time (ISO 8601) |
| --participant | Attendee email; can be used multiple times |
| --location | Event location |
| --description | Event description or body |
| --all-day | Create an all-day event |
| --busy | Mark time as busy |
| --calendar(-c) | Calendar ID (defaults to primary) |
| --free | Mark time as free (not busy) |
| --ignore-dst-warning | Skip DST conflict warnings |
| --ignore-working-hours | Skip working hours validation |
| --lock-timezone | Lock event to its timezone (always display in this timezone) |
| --timezone | IANA timezone for start/end times (e.g., America/Los_Angeles). Defaults to system timezone. |
Examples
The nylas calendar events create command adds a new event to your connected calendar.
Create a 1-hour meeting
nylas calendar events create --title "Sprint Planning" --start 2026-03-30T10:00:00Z --end 2026-03-30T11:00:00Z --participant alice@example.com --participant bob@example.comCreate an all-day event
nylas calendar events create --title "Company Offsite" --start 2026-04-15 --end 2026-04-16Create event with Zoom link in description
nylas calendar events create --title "Weekly Sync" --start 2026-03-31T14:00:00Z --end 2026-03-31T14:30:00Z --location "https://zoom.us/j/123456789" --description "Agenda: status updates, blockers"Example output
✓ Event created (evt_abc123)
Title: Sprint review
When: 2026-07-01 14:00 - 15:00
Calendar: cal_abc123
Participants: alice@example.com, bob@example.comTroubleshooting
Event created but participants not notified
Notification behavior depends on the provider. Google Calendar sends invites automatically; some IMAP providers do not.
Start time must be before end time error
Check that --start is earlier than --end. For all-day events, use date-only format (YYYY-MM-DD) with --end as the day after.
Recommended guides
Book meeting rooms from the CLI
Book meeting rooms from the CLI by listing calendar resources, using each room email as a calendar ID, and adding it as an event participant with less setup.
Google Calendar API Sync Tokens
Use Google Calendar API sync tokens for incremental event sync, handle the 410 GONE full-resync, and read calendars from the CLI.
Microsoft Graph calendarView Explained
Query the Microsoft Graph calendarView endpoint for events in a date range with recurrences expanded. Compare it to list events and read calendars from the CLI.
Microsoft Graph getSchedule Free/Busy
Call the Microsoft Graph getSchedule action to read free/busy for Outlook and Exchange calendars, then check availability across providers from the CLI.
Google Workspace CLI: Limits and Alternative
What gws covers, where its OAuth scope limits and pre-1.0 status bite, and when a multi-provider email and calendar CLI is the better fit.
SavvyCal vs Nylas: Scheduling Compared
SavvyCal is a scheduling SaaS for end users. Nylas is the API and CLI for building scheduling into your product across Google, Microsoft, and iCloud calendars.
Run nylas calendar events create --help for full help output.