---
title: "Batch Add Pending Subscribers"
method: POST
path: "/orgunit/{orgunitId}/groups/{groupId}/subscribers/batch"
tags: ["Subscriber"]
---

# Batch Add Pending Subscribers

`POST /orgunit/{orgunitId}/groups/{groupId}/subscribers/batch`

This API allows you to add multiple subscribers to a specific group in a single batch operation. 

**Compliance & Delivery Workflow:**
* **Pending State:** All subscribers added via this endpoint are initially placed in a `pending` state.
* **Deferred Compliance:** Compliance notifications are **not** dispatched at the time the subscribers are added.
* **Trigger-Based Activation:** The compliance process is only initiated when a message send is triggered for the pending subscriber. 
* **Message Delivery:** Once the compliance check is successful, the initiated message will be delivered to the subscriber.

## Path parameters

- `orgunitId` string, required
- `groupId` string, required

## Request body

- BatchSubscriberOptinParam[]
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `mobileNo` string, required
  - `imageUrl` string, nullable
  - `email` string, nullable
  - `gender` string, nullable
  - `address` Address
    - `address1` string, nullable
    - `state` string, nullable
    - `postalCode` string, nullable
    - `countryCode` string, nullable
  - `relations` Relation[], nullable
    - `name` string, nullable
    - `relationship` string, nullable
  - `mobileCountryCode` string, required
  - `properties` Properties[], nullable
    - `name` string, nullable
    - `value` string, nullable

## Response `202`

Success

- SubscriberResponseExternalApiResponseNew
  - `data` SubscriberResponse
    - `id` string, nullable
  - `appCode` string, nullable
  - `message` string, nullable
  - `isError` boolean

## Other responses

- `400` — Bad Request

## Changes

- **2026-09-29** `043054ed67bf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ministrybytext/apis/pbt-api-documentation/changes/orgunit/:orgunitId/groups/:groupId/subscribers/batch/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.dev/ministrybytext/apis/pbt-api-documentation/revisions/043054ed67bf?raw)