agenda

Search or list emails (v2)

Changed on

Email search and listing across ALL of the authenticated user's connected mail accounts, fetched live from the providers (Google / Microsoft) — Dex stores no message content. Omit searchQuery to list newest-first; pass it to match subject, body, and participants as plain text (provider search operators are neutralized). folder=inbox restricts to received mail (the default spans the whole mailbox, including sent). Optional limit (default 25) and dateRange.{start,end} scope the window, defaulting to roughly the last 6 months; cursor (the previous response's pagination.nextCursor) continues a listing. Returns { data: { email_messages, pagination } } with sender, participants, subject, snippet, and a provider deep link per message.

get/v2/agenda/email/messages

Request

  • Base URL: https://api.prod.getdex.com
  • URL: https://api.prod.getdex.com/v2/agenda/email/messages
  • Auth: HTTP bearer

Query parameters

limitinteger
searchQuerystring
folder'inbox' | 'all'
cursorstring
startstring date-time
endstring date-time

Response

Successful response

Changes

    • breaking

      for the query request parameter limit, the max was decreased from 9007199254740991.00 to 100.00

    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter folder

    • info

      api operation id listEmailMessagesV2 was added