---
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

## Changes

- **2026-08-18** `ae1e3ddfb2fb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ministrybytext/apis/pbt-api-documentation/changes/accounts/segment-lists/file/post.md)

---

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