NYnylas
Send events

List send events

Changed on

Returns what happened to your messages, one event per recipient: accepted, delivered, bounced, marked as spam, or rejected. Filter by recipient, message, sender, or event type to find out why a message didn't reach someone, or to list every hard bounce from a sending domain.

Covers transactional and Agent Account sends. Events are kept for 90 days, and the default window is the last 7 days. Results are sorted by event time, newest first.

This endpoint is for looking back at events, not for real-time updates. Avoid polling it for new events. To act on each delivery outcome as it happens, use webhook notifications.

get/v3/activity/send

Request

Query parameters

event_typestring[]

Return only these event types. Repeat the parameter to include more than one.

bounce_class'hard' | 'soft' | 'undetermined'

Return only bounces of this class.

recipientstring

Return only events for this recipient email address.

recipient_domainstring

Return only events for recipients at this domain.

sending_domainstring

Return only data for messages sent from this domain.

fromstring

Return only events for messages sent from this email address.

grant_idstring

Return only events for messages sent by this Agent Account grant.

message_idstring

Return only events for this message.

thread_idstring

Return only events for messages in this Agent Account thread.

startinteger

Return events at or after this time, as a Unix timestamp in seconds. Defaults to midnight UTC six days ago, so the default window covers the last 7 days. Activity is kept for 90 days, so an earlier value returns events from the last 90 days only.

endinteger

Return events at or before this time, as a Unix timestamp in seconds. Defaults to the time of the request. Must not be earlier than start.

order'desc' | 'asc'

The sort order of the results by event time. desc returns the newest events first.

limitinteger

The maximum number of objects to return. See Pagination for more information.

page_tokenstring

An identifier that specifies which page of data to return. You can get this value from the next_cursor response field. See Pagination for more information.

Response

Success. Returns a page of send events.

request_idstring

The request ID.

next_cursorstring nullable

A cursor pointing to the next page of results for the request.

Example response

{
  "request_id": "5fa64c92-e840-4357-86b9-2aa364d35b88",
  "next_cursor": "CigKGjRlaDdyNGQydTFqbWJ0bGo5a2QxdWJtdDZnGAEggIDAu7fw7bEYGg8IABIAGPjh2PGEi_0CIAEiBwgCEOqs6i4="
}

Changes