API endpoint: email message timeline events

Oct 9, 2024

Our new API endpoint gives teams the ability to access the full timeline of events on an individual email message. These events include when the message was created, every open, click, bounce, or any other event found in our email event message logs.

Message timeline

This is especially helpful for teams that want to show this timeline of events to their own customers. For example, a CRM software platform may want to show these delivery events to help their customers better understand deliverability.

GET /v1/email_messages/EMAIL_MESSAGE_ID/events

Example response:

{
  "meta": {
    "count": 5,
    "page": 1,
    "limit": 50
  },
  "data": [
    {
      "id": "log_Davifvij7cBN96r9",
      "type": "EmailMessageLog",
      "createdAt": "2024-08-23T18:10:21.868Z",
      "updatedAt": "2024-08-23T18:10:21.868Z",
      "code": "EMAIL_MESSAGE_OPEN_SES_EVENT",
      "message": "Email was opened by a recipient at IP address 66.249.91.165. User agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246 Mozilla/5.0"
    },
    {
      "id": "log_8MXy5akcYqwXL7YJ",
      "type": "EmailMessageLog",
      "createdAt": "2024-08-23T18:10:20.215Z",
      "updatedAt": "2024-08-23T18:10:20.215Z",
      "code": "EMAIL_MESSAGE_DELIVERED_SES_EVENT",
      "message": "Email successfully delivered to jordan@usewaypoint.com. Delivery time: 2 seconds."
    },
    {
      "id": "log_YcTNPR5MYjRpaEh8",
      "type": "EmailMessageLog",
      "createdAt": "2024-08-23T18:10:19.184Z",
      "updatedAt": "2024-08-23T18:10:19.184Z",
      "code": "EMAIL_MESSAGE_SENT_SES_EVENT",
      "message": "Email was sent."
    },
    {
      "id": "log_nUHH2sZVhZhkKb5N",
      "type": "EmailMessageLog",
      "createdAt": "2024-08-23T18:10:19.147Z",
      "updatedAt": "2024-08-23T18:10:19.147Z",
      "code": "EMAIL_MESSAGE_RENDERED",
      "message": "Email was processed by Waypoint."
    },
    {
      "id": "log_DkonKJ4aLgJS6Kgr",
      "type": "EmailMessageLog",
      "createdAt": "2024-08-23T18:10:19.032Z",
      "updatedAt": "2024-08-23T18:10:19.032Z",
      "code": "EMAIL_MESSAGE_CREATED",
      "message": "Email message was created."
    }
  ]
}