Skip to content
Skip to main content
GET
https://api.us.nylas.com/v3/activity/send/messages/{message_id}

Return a message's delivery status

Returns the delivery timeline of one message for each of its recipients: when Nylas accepted it, and whether it was delivered, bounced, marked as spam, or rejected. Use it to check whether a message reached a recipient and, if it didn't, why. Covers messages sent in the last 90 days.

NYLAS API KEY

Parameters

Path parameters

message_id*string

The ID of the message. For an Agent Account send, this is the message ID the send returned. For a transactional send, it's the message's Message-ID header, such as <[email protected]>. Percent-encode it in the path: %3C0100019a1b2c3d4e%40mail.example.com%3E.

Example: "5a8f7b2e-3c1d-4e9f-8a6b-2d4c6e8f0a1b"

Responses

request_idstring

The request ID.

dataobject

A message and what happened to it for each recipient.

GEThttps://api.us.nylas.com/v3/activity/send/messages/5a8f7b2e-3c1d-4e9f-8a6b-2d4c6e8f0a1b

Find your API key in the Nylas Dashboard under API Keys in your application settings.

message_idrequiredstring

The ID of the message. For an Agent Account send, this is the message ID the send returned. For a transactional send, it's the message's Message-ID header, such as <[email protected]>. Percent-encode it in the path: %3C0100019a1b2c3d4e%40mail.example.com%3E.