Objective
This article shows you how to read a message's delivery timeline and error information, so you can see how far the message got, which stage it stalled at, and what error code explains the failure.
Product
Programmable Messaging
Environment
Twilio Console
User Account Permission/Role(s) Required
Opening a message's details requires the message logs read permission on the account.
Procedure
- In the Twilio Console, select Monitor in the left sidebar.
- Select Logs, then Messaging.
- Find the failed message. Rows for undelivered, failed and canceled messages are highlighted, and you can search by the message SID if you have it.
- Select the Date value on the row to open Message Details.
- Check the status badge in the page header for the message's final status.
- Scroll to the Delivery Steps table. Its columns are Timestamp, Elapse Time, Event and Stage.
- Read the rows in order. Event names what happened — for example Message Created, Sent, Delivered, Undelivered, Failed, Expired, Delivery Unknown, Received, Read or Cancelled. Stage tells you where it happened: Twilio Platform, Outbound Queue, Carrier Network or Inbound Request.
- Use Elapse Time to see how long each step took relative to the first step — the step where the gap opens up is where the message was held.
- If the message recorded problems, review the Errors and Warnings section for the error code and its explanation.
Additional Information
- Delivery Steps are retained for 7 days. For an older message the section shows "Your Delivery Steps have expired." and advises you to troubleshoot with a more recent message instead.
- The Errors and Warnings section only appears when the message has recorded notifications carrying an error code.
- If the requested message cannot be loaded, the page reports "The requested message could not be found or there was an error loading the data."
- Delivery Steps are not available in the Ireland region.
- For account-wide error trends rather than one message, use the Error Codes charts in Messaging Insights.
This content was generated by AI and reviewed, edited, and verified by a human.