1MSG
ReferenceCampaigns API

Reply feed

GET
/api/v1/campaigns/{campaignId}/analytics/replies

replyType is button or text. buttonId filters one button. phone and bsuid filter one recipient. dateFrom and dateTo are ISO-8601. providerConversationId is the provider chat id. messageId and providerMessageId are the provider message id.

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

campaignId*string

Campaign id returned by create or list.

Query Parameters

replyType?string

button keeps button taps. text keeps free-text replies. Omit to return both.

Value in"button""text"
buttonId?string

One template button id.

phone?string

E.164 phone of one recipient.

bsuid?string

Provider BSUID of one recipient, for example ab.abc123xyz.

dateFrom?string

ISO-8601 start, inclusive, for example 2026-11-01T00:00:00Z.

dateTo?string

ISO-8601 end, inclusive, for example 2026-11-02T00:00:00Z.

limit?number

Page size, from 1 to 100. Default 50.

cursor?string

nextCursor from the previous page. Leave empty for the first page.

Response Body

application/json
  1. response
campaignId*string

Campaign id.

totalReplies*number

Reply count for the whole campaign, not just this page.

uniqueRepliers*number

How many recipients replied at least once in the whole campaign.

items*array<>

Replies on this page, oldest first.

nextCursor*|

Cursor for the next page, or null on the last page.

curl -X GET 'https://api.1msg.io/api/v1/campaigns/string/analytics/replies'
{  "campaignId": "cm3campaign01",  "totalReplies": 4,  "uniqueRepliers": 3,  "items": [    {      "type": "button",      "buttonId": "shop",      "text": "string",      "phone": "+15551234567",      "bsuid": "ab.abc123xyz",      "name": "Ana",      "conversationId": "cm3dialog01",      "providerConversationId": "[email protected]",      "receivedAt": "2026-11-01T09:00:00.000Z",      "messageId": "wamid.HBgM",      "providerMessageId": "wamid.HBgM"    }  ],  "nextCursor": null}