Create calendar event
Add an event to a calendar, with time, location and description.
POST https://cotlet.dev/api/v1/nextcloud/calendar-events
write Confirm
Adds one event to a writable calendar. Give start and end with a time zone, or set all_day. Returns the event ID. Run list_events first to avoid an overlap. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| calendar string required | string | Calendar from list_calendars. |
| title string required | string | Event title. |
| start datetime required | datetime | Start time with a time zone. |
| end datetime required | datetime | End time with a time zone. |
| all_day boolean | boolean | All-day event. Default: false. |
| location string | string | Place or meeting link. |
| description string | string | Event notes. |
Request
curl -X POST https://cotlet.dev/api/v1/nextcloud/calendar-events \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"calendar":"calendar","title":"title","start":"2026-10-01T09:00:00Z","end":"2026-10-01T09:00:00Z"}'result = client.call("nextcloud", "create_calendar_event", {"calendar":"calendar","title":"title","start":"2026-10-01T09:00:00Z","end":"2026-10-01T09:00:00Z"})const result = await cotlet.call('nextcloud', 'create_calendar_event', {"calendar":"calendar","title":"title","start":"2026-10-01T09:00:00Z","end":"2026-10-01T09:00:00Z"});cotlet call nextcloud create_calendar_event --data '{"calendar":"calendar","title":"title","start":"2026-10-01T09:00:00Z","end":"2026-10-01T09:00:00Z"}'Example response
{
"event_id": "d09b6a3c-81e4-4f77-b2a5-6e1c3f7a9d44",
"calendar": "work",
"title": "Acme kickoff",
"start": "2026-10-21T10:00:00+02:00",
"end": "2026-10-21T11:00:00+02:00",
"status": "created"
}