How it works
Each entry in the shows status, notification, recipient, and the provider channels the message went through. Open a message to see its timeline: each status change, the provider response, and any error. Filter the list by status, provider, or error to find a specific class of failure.Finding one message
Each message has a message id (requestId), the same value the and return. Use it to match a log entry to an API response or a webhook event.
Reading a status
A message’s status only ever advances. Two independent systems drive it. Provider confirmation producesDELIVERED. Courier tracking produces OPENED and CLICKED, so engagement can appear before, or without, a delivery confirmation.
For the full status table and the send-time reasons a message never reaches a provider, see .
Limits & behavior
- A message stuck at
SENTis usually not lost. Courier handed it to the provider but has no delivery confirmation. Usually delivery tracking is not configured for that channel. DELIVEREDdepends on the provider. Not every provider confirms delivery, so a missingDELIVEREDis not proof of failure. TreatOPENEDandCLICKEDas receipt signals.- Logs are per message, not per recipient group. A broadcast to a list produces one log entry per recipient. Use for the roll-up.
- Retention depends on your plan. Developer and Business keep 30 days of message history. Enterprise keeps 365 days. Searches and reads are clipped to that window, so export anything you need to keep longer. A message’s own event history is capped at roughly 93 days on every plan, so an older message still lists but returns no timeline.
FAQ
How do I match a log entry to my send request?
How do I match a log entry to my send request?
Use the message id (
requestId) from your Send API response. It is the same id shown in the log and carried on the message:updated webhook.A message is stuck at SENT. Is it lost?
A message is stuck at SENT. Is it lost?
Usually not.
SENT means Courier handed it to the provider without a delivery confirmation. Check the provider’s delivery-status setup.Why did a message open before it was delivered?
Why did a message open before it was delivered?
Opens and clicks are tracked the instant the recipient acts.
DELIVERED waits on the provider’s asynchronous confirmation, so engagement can arrive first.