{
"account_id": "acct_01japd271aeatb7txrzr2xj8sg",
"data": {
"attachments": [
{
"id": "att_01jjnn75vgepj8bnnttfw1st5s",
"type": "image",
"url": "https://toretto.family/skyline.jpg"
}
],
"blast_id": null,
"body": "Dude, I almost had you!",
"conversation": {
"contact": {
"first_name": "Dominic",
"id": "ctc_01ja88cboqffhswjx8zbak3ykk",
"last_name": "Toretto",
"phone_number": "+18015551234"
},
"id": "cnv_01jav8xy7fe4nsay3c9deqxge9",
"phone_number": {
"campaign_id": "cpn_01jjnn7s0zfx5tdcsxjfy93et2",
"id": "pn_01jsjwe4d9fx3tpymgtg958d9w",
"metadata": {
"location": "Downtown store"
},
"name": "(801) 555-6789",
"number": "+18015556789",
"type": "local"
}
},
"created_at": "2024-10-21T23:29:40Z",
"failure_reason": null,
"id": "msg_01jjnn7s0zfx5tdcsxjfy93et2",
"metadata": {
"order_id": "12345"
},
"sent_at": "2024-10-21T23:29:41Z",
"status": "sent"
},
"timestamp": "2024-10-21T23:29:41Z",
"type": "message.sent"
}Events
message.sent
Fires when Surge accepts an outbound message and passes it to the carrier for delivery.
WEBHOOK
messageSent
{
"account_id": "acct_01japd271aeatb7txrzr2xj8sg",
"data": {
"attachments": [
{
"id": "att_01jjnn75vgepj8bnnttfw1st5s",
"type": "image",
"url": "https://toretto.family/skyline.jpg"
}
],
"blast_id": null,
"body": "Dude, I almost had you!",
"conversation": {
"contact": {
"first_name": "Dominic",
"id": "ctc_01ja88cboqffhswjx8zbak3ykk",
"last_name": "Toretto",
"phone_number": "+18015551234"
},
"id": "cnv_01jav8xy7fe4nsay3c9deqxge9",
"phone_number": {
"campaign_id": "cpn_01jjnn7s0zfx5tdcsxjfy93et2",
"id": "pn_01jsjwe4d9fx3tpymgtg958d9w",
"metadata": {
"location": "Downtown store"
},
"name": "(801) 555-6789",
"number": "+18015556789",
"type": "local"
}
},
"created_at": "2024-10-21T23:29:40Z",
"failure_reason": null,
"id": "msg_01jjnn7s0zfx5tdcsxjfy93et2",
"metadata": {
"order_id": "12345"
},
"sent_at": "2024-10-21T23:29:41Z",
"status": "sent"
},
"timestamp": "2024-10-21T23:29:41Z",
"type": "message.sent"
}Fires when Surge accepts an outbound message and sends it to the carrier network. This event fires before delivery is confirmed. Listen to
message.delivered for the carrier’s delivery receipt.
Common use case
Usemessage.sent to update your own records when a send is confirmed. Pair it with message.delivered to track the full delivery lifecycle.Authorizations
Body
application/json
Response
200
Return a 200 status to indicate that the data was received successfully