Inbound message received | Message Blue

Delivered to the inboundWebhookUrl you set with POST /settings/webhooks when a contact sends a message to one of your agents. Verify X-MB-Signature against the raw request bytes before trusting the payload.

Payload

The payload of this webhook request is an object.

typeenumOptional

messageIdstringOptional

textstring or nullOptional

fromstring or nullOptional

Sender handle (E.164 phone or email), canonicalized.

tostring or nullOptional

outboundbooleanOptional

iMessageNumberstring or nullOptional

The agent number that received it.

participantslist of strings or nullOptional

chatGuidstring or nullOptional

groupIdstring or nullOptional

messageGuidstring or nullOptional

attachmentslist of stringsOptional

timestamp_mslongOptional

accountIdstring or nullOptional

Response

200

any

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

1	{
2	"type": "inbound_message",
3	"messageId": "9c8f1e42-5b7a-4d31-8f60-2ab4c9d17e83",
4	"text": "Hey — is my order still arriving today?",
5	"from": "+14155550123",
6	"to": "+16475137145",
7	"outbound": false,
8	"iMessageNumber": "+16475137145",
9	"participants": [
10	"+14155550123",
11	"+16475137145"
12	],
13	"chatGuid": "iMessage;-;+14155550123",
14	"groupId": null,
15	"messageGuid": "6F1C2A54-6C1E-4E2B-9E0A-2B7C1D3E4F50",
16	"attachments": [],
17	"timestamp_ms": 1769472000000,
18	"accountId": "acct_4f9c2b7e1d8a"
19	}