Agenda

List calendar events

External calendar events fetched live from the authenticated user's connected Google / Office365 credentials via the sync-engine — there's no DB table. Optional `limit` and `dateRange.{start,end}` (IS

GET /v2/agenda/calendar/events

Parameters

Query parameters

limit

integer

searchQuery

string

dateRange

object

Responses

200 — Successful response

Content-Type: application/json

data

object required

data.calendar_events

array<object> required

data.calendar_events[].providerId

string required

data.calendar_events[].type

string enum required

Possible values: "EMAIL", "CALENDAR"

data.calendar_events[].subjectOrTitle

string required

data.calendar_events[].dateTime

string (date-time) required

data.calendar_events[].endDateTime

string (date-time)

data.calendar_events[].isAllDay

boolean | null

data.calendar_events[].participants

array<object> required

data.calendar_events[].participants[].email

string required

data.calendar_events[].participants[].name

string | null

data.calendar_events[].providerLink

string | null

data.calendar_events[].email

string required

data.calendar_events[].iCalUID

string | null

data.calendar_events[].summaryOfEvent

string | null

data.calendar_events[].descriptionOfEvent

string | null

data.calendar_events[].conferenceData

object | null

data.calendar_events[].conferenceData.conferenceId

string | null

data.calendar_events[].conferenceData.entryPoints

array<object> | null

data.calendar_events[].conferenceData.entryPoints[].uri

string | null

data.calendar_events[].conferenceData.entryPoints[].label

string | null

data.calendar_events[].conferenceData.entryPoints[].accessCode

string | null

data.calendar_events[].isRecurring

boolean | null

data.calendar_events[].provider

string | null

data.pagination

object

data.pagination.nextCursor

string | null

data.pagination.count

integer

Example

{
  "data": {
    "calendar_events": [
      {
        "providerId": "string",
        "type": "EMAIL",
        "subjectOrTitle": "string",
        "dateTime": "2026-08-21T15:31:00.956Z",
        "participants": [
          {
            "email": "string"
          }
        ],
        "email": "string"
      }
    ]
  }
}

400

No response body.

401

No response body.

403

No response body.

404

No response body.

409

No response body.

429

No response body.

500

No response body.

Code samples

curl https://api.prod.getdex.com/v2/agenda/calendar/events \
  --header 'Authorization: Bearer YOUR_API_KEY'

fetch('https://api.prod.getdex.com/v2/agenda/calendar/events', {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY'
  }
})

requests.get(
    "https://api.prod.getdex.com/v2/agenda/calendar/events",
    headers={
      "Authorization": "Bearer YOUR_API_KEY"
    }
)

Delete a contact address

Remove an address from a contact. Idempotency-Key is optional. Returns `{ data: { affected } }`.

Create a calendar event

Create an event on the connected calendar (primary account by default). Set start_datetime/end_datetime for a timed event, or start_date/end_date for an all-day event (end date exclusive). **Requires