API referenceMessages

GET /inbox/conversations/{id}/messages

Messages of a conversation, oldest → newest within the page; before pages back in time

GET
/inbox/conversations/{id}/messages

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

id*string

Conversation id

Query Parameters

limit?integer

Maximum items (default 50, max 100)

Range1 <= value <= 100
Default50
before?string

nextBefore of the previous page

Response Body

{conversationId, messages, nextBefore}

application/json
  1. response
conversationId?string
messages?array<>
nextBefore?|

Pass as before for older messages

Example Request
curl -X GET 'https://example.com/api/v1/inbox/conversations/string/messages'
Example Response
{  "conversationId": "string",  "messages": [    {      "id": "string",      "conversationId": "string",      "platformMessageId": "string",      "direction": "inbound",      "type": "text",      "text": "string",      "attachments": [        {          "type": "string",          "url": "string"        }      ],      "postback": {        "title": "string",        "payload": "string"      },      "reactions": [        {          "emoji": "string",          "by": "participant"        }      ],      "replyToMid": "string",      "isEcho": true,      "isDeleted": true,      "status": "received",      "tag": "HUMAN_AGENT",      "sentAt": "2019-08-24T14:15:22Z",      "deliveredAt": "2019-08-24T14:15:22Z",      "readAt": "2019-08-24T14:15:22Z",      "source": "webhook",      "content": null,      "pricing": null,      "error": "string",      "failedAt": "2019-08-24T14:15:22Z"    }  ],  "nextBefore": "string"}

PATCH /inbox/conversations/{id} PATCH

Archive or unarchive a conversation (Postgale only; a new inbound message makes it active again)

POST /inbox/conversations/{id}/messages POST

Send a LIVE direct message to the participant: text (Instagram ≤1000, Messenger ≤2000 characters) or one attachment (mediaUrl or mediaId), not both. Allowed within 24 hours of the participant's last message, or within 7 days with tag HUMAN_AGENT (needs Meta's Human Agent permission); otherwise 409 outside_messaging_window without calling Meta. WhatsApp conversations take the WhatsAppOutbound fields (text ≤4096, mediaUrl / mediaId / whatsappMediaId with caption, template, interactive, location or reaction, replyTo; no tag): within 24 hours anything, outside only a template. 403 approval_required while approval applies; 403 missing_permission without the messaging permission. Emits message.sent