---
title: "Upload Segment Subscriber File"
method: POST
path: "/accounts/segment-lists/file"
tags: ["Segment List"]
---

# Upload Segment Subscriber File

`POST /accounts/segment-lists/file`

Uploads a CSV file containing subscriber details to the server.  Upon successful upload, the endpoint returns a hosted file URL  ('fileurl') inside the response payload, which can then be passed to  the Create Segment List endpoint to automatically populate a new list.
    
Sample File:  https://gopbt.me/9e05qH

## Response `201`

Success

- AddSegmentResponseExternalApiResponseNew
  - `data` AddSegment
    - `fileurl` string
  - `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)