calendar.create
Create a new calendar event
Scope: calendar:write
Create a new event on the identity's calendar.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Event title |
description | string | No | Event description |
startAt | string | Yes | Start date/time (ISO 8601) |
endAt | string | No | End date/time (ISO 8601) |
isAllDay | boolean | No | All-day event (default: false) |
location | string | No | Event location |
metadata | object | No | Custom metadata |
Example
Agent: "Create a team sync meeting for tomorrow at 10am"
-> calendar.create({
title: "Team Sync",
description: "Weekly standup",
startAt: "2026-04-07T10:00:00.000Z",
endAt: "2026-04-07T11:00:00.000Z",
location: "Zoom"
})Returns
{
"eventId": "evt_abc123",
"title": "Team Sync",
"description": "Weekly standup",
"startAt": "2026-04-07T10:00:00.000Z",
"endAt": "2026-04-07T11:00:00.000Z",
"isAllDay": false,
"location": "Zoom",
"createdAt": "2026-04-06T12:00:00.000Z"
}REST Equivalent
POST /v0/calendar