1MSG
ReferenceCampaigns API

List segments

GET
/api/v1/campaigns/segments

Newest first. limit is the page size, default 50, maximum 100. cursor is the nextCursor from the previous page. Leave cursor empty for the first page.

Authorization

bearer
headerAuthorizationBearer <token>

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

Query Parameters

limit?string

Page size. Defaults to 50, maximum 100.

cursor?string

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

Response Body

application/json
  1. response
items*array<>

Segments on this page, newest first.

nextCursor*|

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

curl -X GET 'https://api.1msg.io/api/v1/campaigns/segments'
{  "items": [    {      "id": "cm3segment01",      "name": "April buyers",      "description": "string",      "memberCount": 12    }  ],  "nextCursor": null}