Dex Guide
Dex Dashboard
Agenda

Search emails

Free-text email search across ALL of the authenticated user's connected mail accounts, fetched live from the providers (Google / Microsoft) — Dex stores no message content. `searchQuery` matches subje

GET /v2/agenda/email/messages

Parameters

Query parameters

limit
integer
searchQuery
string
dateRange
object

Responses

200 — Successful response

Content-Type: application/json

data
object required
data.email_messages
array<object> required
data.email_messages[].providerId
string required
data.email_messages[].threadId
string | null
data.email_messages[].type
string enum required
Possible values: "EMAIL", "CALENDAR"
data.email_messages[].subjectOrTitle
string required
data.email_messages[].snippet
string | null
data.email_messages[].dateTime
string (date-time) required
data.email_messages[].from
object | null
data.email_messages[].from.email
string
data.email_messages[].from.name
string | null
data.email_messages[].participants
array<object> required
data.email_messages[].participants[].email
string required
data.email_messages[].participants[].name
string | null
data.email_messages[].providerLink
string | null
data.email_messages[].email
string required
data.email_messages[].provider
string | null
data.pagination
object
data.pagination.nextCursor
string | null
data.pagination.count
integer

Example

{
  "data": {
    "email_messages": [
      {
        "providerId": "string",
        "type": "EMAIL",
        "subjectOrTitle": "string",
        "dateTime": "2026-08-21T15:31:00.957Z",
        "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/email/messages \
  --header 'Authorization: Bearer YOUR_API_KEY'

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

Get a calendar event

Retrieve a single calendar event by its provider event ID, including attendees, conferencing links, and recurrence flags. Reads from the primary connected calendar unless `account_email` selects anoth

Copyright © 2026