The calendar event object

{
  "id": "cev_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "object": "calendar_event",
  "meeting_id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "ical_uid": "b3f1a9c2@gurusup.com",
  "recurring": false,
  "title": "Weekly sync with Acme",
  "starts_at": "2026-09-29T09:00:00Z",
  "ends_at": "2026-09-29T09:30:00Z",
  "meeting_url": "https://meet.google.com/abc-defg-hij",
  "organizer": { "name": "Laia Puig", "email": "laia@gurusup.com", "member_id": "mem_01k69x2m4q8r7t6v5w4x3y2z1a" },
  "attendees": [
    { "name": "Laia Puig", "email": "laia@gurusup.com", "member_id": "mem_01k69x2m4q8r7t6v5w4x3y2z1a", "response": "accepted" },
    { "name": "Ana Ruiz", "email": "ana@acme.com", "member_id": null, "response": "needs_action" }
  ],
  "source": "calendar_sync",
  "metadata": { "gurusup_event_id": "evt_311" },
  "cancelled_at": null,
  "created_at": "2026-09-22T08:00:00Z",
  "updated_at": "2026-09-28T17:12:03Z"
}

{
  "id": "cev_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "object": "calendar_event",
  "meeting_id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "ical_uid": "b3f1a9c2@gurusup.com",
  "recurring": false,
  "title": "Weekly sync with Acme",
  "starts_at": "2026-09-29T09:00:00Z",
  "ends_at": "2026-09-29T09:30:00Z",
  "meeting_url": "https://meet.google.com/abc-defg-hij",
  "organizer": { "name": "Laia Puig", "email": "laia@gurusup.com", "member_id": "mem_01k69x2m4q8r7t6v5w4x3y2z1a" },
  "attendees": [
    { "name": "Laia Puig", "email": "laia@gurusup.com", "member_id": "mem_01k69x2m4q8r7t6v5w4x3y2z1a", "response": "accepted" },
    { "name": "Ana Ruiz", "email": "ana@acme.com", "member_id": null, "response": "needs_action" }
  ],
  "source": "calendar_sync",
  "metadata": { "gurusup_event_id": "evt_311" },
  "cancelled_at": null,
  "created_at": "2026-09-22T08:00:00Z",
  "updated_at": "2026-09-28T17:12:03Z"
}

A calendar event is what POST /calendar_events returns, and what a meeting from a calendar carries as its calendar_event: the same object, with the same cev_ id. There is one per meeting. Every member who has the event on their calendar shares it, so a push for any of them returns it. Its times, link and title are the meeting’s; its people come from the organizer’s copy. See Push calendar events.

Attributes

string

Beginning with cev_. One per meeting; stays the same through reschedules and every member’s push.

string

Always calendar_event.

string

The meeting of this occurrence, beginning with mtg_.

string | null

The iCal UID shared by every attendee’s copy of the event, or null when the calendar sent none.

boolean | null

Whether the event is an occurrence of a recurring series, or null when it is unknown.

string | null

The event title.

string | null

Scheduled start, in ISO 8601.

string | null

Scheduled end, in ISO 8601.

string | null

The link to join the call, or null when the event has none.

object | null

Who organizes the event, or null when unknown.

Show properties

string | null

The organizer’s name, when the calendar has one.

string | null

The organizer’s email.

string | null

Set when the organizer is a member of the workspace.

object[]

Everyone on the invite, the organizer included. Empty once no member has the event.

Show properties

string | null

The attendee’s name, when the calendar has one.

string | null

The attendee’s email.

string | null

Set when the attendee is a member of the workspace.

string | null

The attendee’s answer to the invite, or null when the calendar does not say.

accepted: accepted.
declined: declined.
tentative: answered maybe.
needs_action: has not answered.

string

Where the event came from.

calendar_connection: a calendar the member connected.
calendar_sync: an event you pushed with POST /calendar_events.

object

Your key-value pairs, set with POST /calendar_events and merged on every push ("" removes a key, metadata: "" removes them all). Shared by every member’s push of the event; never copied to the meeting. See metadata.

string | null

When the event was cancelled, once no member of the workspace still has it; otherwise null.

string

When the event first appeared, in ISO 8601.

string

When the event or its meeting last changed, in ISO 8601.

{
  "id": "cev_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "object": "calendar_event",
  "meeting_id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "ical_uid": "b3f1a9c2@gurusup.com",
  "recurring": false,
  "title": "Weekly sync with Acme",
  "starts_at": "2026-09-29T09:00:00Z",
  "ends_at": "2026-09-29T09:30:00Z",
  "meeting_url": "https://meet.google.com/abc-defg-hij",
  "organizer": { "name": "Laia Puig", "email": "laia@gurusup.com", "member_id": "mem_01k69x2m4q8r7t6v5w4x3y2z1a" },
  "attendees": [
    { "name": "Laia Puig", "email": "laia@gurusup.com", "member_id": "mem_01k69x2m4q8r7t6v5w4x3y2z1a", "response": "accepted" },
    { "name": "Ana Ruiz", "email": "ana@acme.com", "member_id": null, "response": "needs_action" }
  ],
  "source": "calendar_sync",
  "metadata": { "gurusup_event_id": "evt_311" },
  "cancelled_at": null,
  "created_at": "2026-09-22T08:00:00Z",
  "updated_at": "2026-09-28T17:12:03Z"
}

Overview

Endpoints

The calendar event object

Attributes

​Attributes

Attributes