{
  "account_id": "acct_01japd271aeatb7txrzr2xj8sg",
  "data": {
    "id": "msg_01jjnn7s0zfx5tdcsxjfy93et2",
    "body": "Dude, I almost had you!",
    "attachments": [
      {
        "id": "att_01jjnn75vgepj8bnnttfw1st5s",
        "type": "image",
        "url": "https://toretto.family/skyline.jpg"
      }
    ],
    "delivered_at": "2024-10-21T23:29:42Z",
    "conversation": {
      "id": "cnv_01jav8xy7fe4nsay3c9deqxge9",
      "contact": {
        "email": "dom@toretto.family",
        "id": "ctc_01ja88cboqffhswjx8zbak3ykk",
        "last_name": "Dominic",
        "first_name": "Toretto",
        "metadata": {
          "car": "1970 Dodge Charger R/T"
        },
        "phone_number": "+18015551234"
      }
    }
  },
  "type": "message.delivered"
}

The message.delivered event is delivered whenever a message sent from your Surge number is delivered to the recipient’s device.

​
Common Use Cases

  • Track delivery status of sent messages in your own system
  • Update conversation analytics
  • Log customer interactions

​
Payload Structure

{
  "account_id": "acct_01japd271aeatb7txrzr2xj8sg",
  "data": {
    "id": "msg_01jjnn7s0zfx5tdcsxjfy93et2",
    "body": "Dude, I almost had you!",
    "attachments": [
      {
        "id": "att_01jjnn75vgepj8bnnttfw1st5s",
        "type": "image",
        "url": "https://toretto.family/skyline.jpg"
      }
    ],
    "delivered_at": "2024-10-21T23:29:42Z",
    "conversation": {
      "id": "cnv_01jav8xy7fe4nsay3c9deqxge9",
      "contact": {
        "email": "dom@toretto.family",
        "id": "ctc_01ja88cboqffhswjx8zbak3ykk",
        "last_name": "Dominic",
        "first_name": "Toretto",
        "metadata": {
          "car": "1970 Dodge Charger R/T"
        },
        "phone_number": "+18015551234"
      }
    }
  },
  "type": "message.delivered"
}
​
account_id
string
required

The ID of the account that sent the message

​
type
string
required

Always message.delivered for this event

​
data
message
​
id
string

The unique identifier for the message

​
body
string

The content of the message

​
attachments
attachment[]
​
delivered_at
string

ISO 8601 timestamp of when the message was delivered

​
conversation
conversation