Inbox Webhooks
Get notified about inbound and outbound direct messages on Meta platforms.
Message events fire when Meta delivers messaging webhooks for a connected Instagram or Facebook account. Every delivery uses the shared envelope described in Webhooks.
No setup needed. Connect the account and message events start flowing to your endpoint automatically.
Events
| Event | When |
|---|---|
message.received | New incoming DM |
message.sent | Outgoing DM is sent (including API sends) |
message.delivered | An outgoing DM is delivered |
message.read | The recipient reads an outgoing DM |
Payloads
message.received (and message.sent):
{
"accountId": "ACCOUNT_ID",
"platform": "instagram",
"senderId": "SENDER_ID",
"recipientId": "RECIPIENT_ID",
"messageId": "MID",
"text": "Hi, is this available?",
"hasAttachments": false,
"sentAt": "2026-09-08T12:00:00.000Z"
}message.delivered:
{
"accountId": "ACCOUNT_ID",
"platform": "facebook",
"senderId": "SENDER_ID",
"recipientId": "RECIPIENT_ID",
"messageIds": ["MID"],
"watermark": 1725710400000,
"sentAt": "2026-09-08T12:00:00.000Z"
}message.read:
{
"accountId": "ACCOUNT_ID",
"platform": "facebook",
"senderId": "SENDER_ID",
"recipientId": "RECIPIENT_ID",
"watermark": 1725710400000,
"sentAt": "2026-09-08T12:00:00.000Z"
}