Direct message received

POST

New direct messages from someone on Facebook or Instagram. Several messages that arrive together come in one delivery.

Headers: X-PostFlow-Event, X-PostFlow-Signature: t=<unix>,v1=<hex> (HMAC-SHA256 of "<t>.<body>" with the webhook’s secret). Answer 2xx within 10 seconds.

Authorizations

• apiKey
• oauth

Request Body^required

Media typeapplication/json

object

event

required

string

Allowed value: message.received

deliveredAt

required

string format: date-time

workspaceId

required

string

account

required

object

id

required

string

platform

required

string

Allowed values: facebook instagram tiktok threads bluesky youtube telegram

name

required

string

username

required

Any of:

string

string

null

null

conversation

required

object

id

required

Use with /inbox/messages/{id}/reply.

string

participant

required

object

id

required

string

name

required

Any of:

string

string

null

null

username

required

Any of:

string

string

null

null

messages

required

Array<object>

object

text

required

string

attachments

required

Number of attachments.

integer

sentAt

required

string format: date-time

Responses

200

Received. Any 2xx works; anything else is retried.