Skip to main content
Creates a new calendar (a CalDAV collection) — useful to keep a workstream’s events separate from the personal calendar. Pass the returned calendarUrl to create_calendar_event to add events to it.

​
Parameters

​
name
string
required
The calendar’s display name. 1–200 characters.
​
color
string
A hex display color, #RRGGBB or #RRGGBBAA (e.g. #7FA6C9). Carried through the calendar-color extension so CalDAV clients show the calendar visually distinct.

​
Example

Call
{ "name": "Marketing", "color": "#7FA6C9" }
Result
Calendar "Marketing" created.
calendarUrl: https://mail.langmail.me/dav/cal/you/a1b2c3/

​
Errors

  • color must be a hex value like #FF6600 — the color value wasn’t a valid hex color.