---
title: "Add Subscribers to Segment List"
method: PUT
path: "/accounts/segment-lists/{listId}/subscribers"
tags: ["Segment List"]
---

# Add Subscribers to Segment List

`PUT /accounts/segment-lists/{listId}/subscribers`

Adds multiple new subscribers to an existing segment list in a single batch request.  Each entry accepts contact details such as phone number, full name, email, avatar image,  and geographic region metadata.

## Path parameters

- `listId` string, required

## Request body

- AddListSubscriberRequest[] — An array of subscriber objects to be added to the list in bulk.
  - `subscriberNo` string, required — The mobile phone number of the subscriber.
  - `firstName` string, nullable — The subscriber's first name.
  - `lastName` string, nullable — The subscriber's last name.
  - `email` string, nullable — The subscriber's first name.
  - `imageUrl` string, nullable — A direct URL hosting the subscriber's avatar or profile picture.
  - `region` string — The geographic territory or region assigned to the subscriber profile.

## Response `200`

Success

- ExternalApiResponseNew
  - `appCode` string
  - `message` string
  - `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)