---
title: "Create Segment List"
method: POST
path: "/accounts/segment-lists"
tags: ["Segment List"]
---

# Create Segment List

`POST /accounts/segment-lists`

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.

## Request body

- CreateListFromSegmentFileRequest
  - `listName` string, required — The unique descriptive name used to identify the segment list.
  - `description` string, nullable — An optional summary providing organizational context or details about the segment list audience.
  - `segmentUrl` string, 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 `202`

Success

- StringListExternalApiResponseNew
  - `data` string[], nullable
  - `appCode` string, nullable
  - `message` string, nullable
  - `isError` boolean

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/ministrybytext/apis/pbt-api-documentation.md) · [All operations](https://skmtc.net/ministrybytext/apis/pbt-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ministrybytext/pbt-api-documentation/revisions/ae1e3ddfb2fb/schema)