/v1/calendar/eventsBook a meeting
Puts a meeting on the caller's own calendar (Google or Microsoft, whichever they connected) and links it to a record. Takes title, startsAt (required), an optional endsAt (the member's default duration when absent) — both RFC3339 instants WITH an offset, such as , written in the person's own time zone (the clock line names it); a bare date or a time with no offset is refused — attendees, meetLink for a video link, and definitionKey + rowId to pin it to a record. attendeesFromRecord adds the record's own addresses and the contacts filed against it; attendeesFromAssignees adds the people its person columns name (opener, closer, owner) — so nobody retypes what the record already knows. To tie a task: taskId links an existing task of this record (refused if it already has a live meeting), or createTask {title, description, dueAt, assigneeAccountId, entityKind} raises one beside the meeting — blanks default to the meeting's title, its start as the due time, the caller as the assignee, and the record's own entity word; the answer carries taskId. Never send both. This is a write: it pauses for the person's approval, which is where they accept or decline the invite before it goes out. When the meeting ALREADY EXISTS on their calendar, do not book another: post_calendar_events_link puts that one on the record.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredan RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
an RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
Responses
the action's answer
{
"data": {
"attendees": [
"string"
],
"calendarId": "",
"cancelledAt": "2026-01-01T00:00:00Z",
"createdAt": "2026-01-01T00:00:00Z",
"definitionId": "",
"definitionKey": "string",
"endsAt": "2026-01-01T00:00:00Z",
"id": "",
"meetingUrl": "string",
"memberUserId": 1,
"origin": "string",
"provider": "string",
"providerEventId": "",
"rowId": "",
"startsAt": "2026-01-01T00:00:00Z",
"status": "string",
"taskId": 1,
"title": "string",
"updatedAt": "2026-01-01T00:00:00Z"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}