latestOpenAPI 3.0.12026-08-1848115403.9 KB

ae1e3ddfb2fb

Segment List

Create Segment List

Creates a new subscriber segment list within the account. This list can be initialized as an empty segment container for adding subscribers later, or populated immediately by passing a 'segmentUrl' obtained from the Upload Segment Subscriber File API.

post/accounts/segment-lists

Request body

listNamestring required

The unique descriptive name used to identify the segment list.

descriptionstring nullable

An optional summary providing organizational context or details about the segment list audience.

segmentUrlstring nullable

An optional file URL obtained from the Segment File Upload API to automatically populate the list with subscribers upon creation. If omitted, an empty segment list is created.

Response

Success

datastring[] nullable

appCodestring nullable

messagestring nullable

isErrorboolean