Delivery status update | Message Blue

Delivered to the statusWebhookUrl you set with POST /settings/webhooks as an outbound message progresses. A per-message status_callback, if you set one when sending, takes precedence over the account-level URL.

This payload has no type field — identify it by status.

Payload

The payload of this webhook request is an object.

messageIdstringOptional

statusstringOptional

e.g. sent, delivered, read, failed, SMS_FALLBACK.

textstring or nullOptional

fromstring or nullOptional

tostring or nullOptional

groupIdstring or nullOptional

attachmentslist of stringsOptional

status_callbackstring or nullOptionalformat: "uri"

outboundbooleanOptional

iMessageNumberstring or nullOptional

participantslist of strings or nullOptional

chatGuidstring or nullOptional

messageGuidstring or nullOptional

timestamp_mslongOptional

errorstring or nullOptional

Response

200

any

Return a 200 status to indicate that the data was received successfully.

1	{
2	"messageId": "7b3e5c19-8d24-4a70-9e31-c5f2a604b8d7",
3	"status": "delivered",
4	"text": "Your order ships today.",
5	"from": "+16475137145",
6	"to": "+14155550123",
7	"groupId": null,
8	"attachments": [],
9	"status_callback": null,
10	"outbound": true,
11	"iMessageNumber": "+16475137145",
12	"participants": [
13	"+14155550123",
14	"+16475137145"
15	],
16	"chatGuid": "iMessage;-;+14155550123",
17	"messageGuid": "6F1C2A54-6C1E-4E2B-9E0A-2B7C1D3E4F50",
18	"timestamp_ms": 1769472012000,
19	"error": null
20	}