List all email activities

Returns the email history the platform keeps for a contact or a deal: one-to-one emails sent from the platform, emails from a connected mailbox (synced in, or sent through it), and campaign emails sent to the contact. reltype says which kind each entry is. Send filters[subscriberid] or filters[dealId]; without either, the read covers every email on the account. With filters[subscriberid], the request first adds any of the contact's emails sent since the last read, then returns the entries. With filters[dealId], it does the same for the deal and its contacts, and returns the emails of the deal's contacts that are tied to this deal or to no deal; users without deal access then see only the emails tied to no deal. Each email appears once. Emails from a connected mailbox that are marked private are returned only to the user they belong to. Subjects have personalization tags filled in, and message bodies have the mailbox service's open-tracking pixel removed, so showing them does not count as an open. Results are paged: limit defaults to 20 and is capped at 100, page with offset, and meta.total is the number of matching emails. This endpoint is read-only.

📘

For the best results

Only single records are intended to be requested, rather than running the call unfiltered.

Query Params
int32

Return only the emails of this contact. An unknown contact id returns 404.

int32

Return only the emails of this deal's contacts that are tied to this deal or to no deal. An unknown deal id returns 404.

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Choose an example:
application/json