1MSG
ReferenceInbox API

Messages in a conversation

GET
/api/v1/inbox/conversations/{conversationId}/messages

Newest first. Omit kind, or pass kind=all, to include SYSTEM events (status, assignee, block, title) together with messages. kind=messages hides SYSTEM events. kind=system returns only SYSTEM events. Notes stay with messages. Pass nextCursor as cursor to load older rows of the same kind.

Authorization

bearer
headerAuthorizationBearer <token>

Key issued in Settings → Developer → API key. Inbox methods need the Inbox scope. Campaigns methods need the Campaigns scope.

Path Parameters

conversationId*string

Conversation id

Query Parameters

limit?number

Page size. Default 50.

cursor?string

nextCursor from the previous page (ISO createdAt). Returns rows older than that instant, still filtered by kind.

kind?string

all (default when omitted): every row. messages: everything except SYSTEM. system: only SYSTEM.

Value in"all""messages""system"

Response Body

application/json
  1. response
messages*array<>

Newest first. Includes SYSTEM events.

nextCursor?|

Pass back as cursor to load older messages. Null on the last page.

Formatdate-time
hasMore*boolean
curl -X GET 'https://api.1msg.io/api/v1/inbox/conversations/string/messages'
{  "messages": [    {      "id": "string",      "conversationId": "string",      "channelId": "string",      "direction": "INBOUND",      "type": "TEXT",      "content": "string",      "mediaUrl": "string",      "mediaType": "string",      "fileName": "string",      "fileSize": 0,      "mediaDuration": 0,      "thumbnailUrl": "string",      "templateName": "string",      "templateLanguage": "string",      "status": "PENDING",      "externalId": "string",      "sentAt": "2019-08-24T14:15:22Z",      "deliveredAt": "2019-08-24T14:15:22Z",      "readAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z",      "systemEventSource": "string",      "systemEventOperatorName": "string",      "systemEventOperatorEmail": "string",      "assignmentEvent": {        "kind": "assign",        "actor": {          "id": "b2bb82f0-2253-4e05-b955-a21f3d699caa",          "name": "QA Stage",          "avatar": null        },        "target": {          "id": "b2bb82f0-2253-4e05-b955-a21f3d699caa",          "name": "QA Stage",          "avatar": null        }      },      "author": {        "id": "b2bb82f0-2253-4e05-b955-a21f3d699caa",        "name": "QA Stage",        "avatar": null      },      "quotedMessage": {        "id": "string",        "content": "string",        "type": "string",        "direction": "INBOUND",        "contactName": "string",        "contactPhone": "string",        "mediaUrl": "string",        "fileName": "string"      },      "latitude": 0,      "longitude": 0    }  ],  "nextCursor": "2019-08-24T14:15:22Z",  "hasMore": true}