> For the complete documentation index, see [llms.txt](https://api.senderwiz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.senderwiz.com/customer/subscribers/create-subscribers-in-bulk.md).

# Create Subscribers in Bulk

### 📥 Create Subscribers in Bulk

Add multiple subscribers to a list using a single API request.

***

#### 🔹 HTTP Request

```http
POST API-URL/lists/LIST-UNIQUE-ID/subscribers/bulk
```

***

#### 🔸 URL Segments

| Segment          | Required | Description             |
| ---------------- | -------- | ----------------------- |
| `LIST-UNIQUE-ID` | Yes      | List unique identifier. |

***

#### 📤 POST Parameters

| Parameter | Type  | Required | Description                                                              |
| --------- | ----- | -------- | ------------------------------------------------------------------------ |
| `array`   | array | Yes      | An array of subscriber arrays, each containing at least the `EMAIL` key. |

***

#### 🔐 Authorization Header

```
X-API-KEY: your-api-key-here
```

***

#### 💻 PHP Example

```php
// ADD SUBSCRIBERS IN BULK
$response = $endpoint->createBulk('LIST-UNIQUE-ID', [
    [
        'EMAIL'    => 'alex.doe@demo.com',
        'FNAME'    => 'Alex',
        'LNAME'    => 'Doe'
    ],
    [
        'EMAIL'    => 'mia.stone@abcmail.com',
        'FNAME'    => 'Mia',
        'LNAME'    => 'Stone'
    ],
    [
        'EMAIL'    => 'noah.lee@dummy.org',
        'FNAME'    => 'Noah',
        'LNAME'    => 'Lee'
    ]
]);

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';
```

***

#### 📦 Sample JSON Response

```json
{
  "status":"success",
  "data": {
    "records": [
      {
        "data": {
          "subscriber_uid": "u1x9zr87yq45a",
          "EMAIL": "alex.doe@demo.com",
          "FNAME": "Alex",
          "LNAME": "Doe",
          "status": "confirmed",
          "source": "import",
          "ip_address": "",
          "date_added": "2025-04-17 14:22:10"
        }
      },
      {
        "data": {
          "subscriber_uid": "v3m0az21xp77k",
          "EMAIL": "mia.stone@abcmail.com",
          "FNAME": "Mia",
          "LNAME": "Stone",
          "status": "confirmed",
          "source": "import",
          "ip_address": "",
          "date_added": "2025-04-17 14:22:10"
        }
      },
      {
        "data": {
          "subscriber_uid": "n8k2bd54rw93m",
          "EMAIL": "noah.lee@dummy.org",
          "FNAME": "Noah",
          "LNAME": "Lee",
          "status": "confirmed",
          "source": "import",
          "ip_address": "",
          "date_added": "2025-04-17 14:22:10"
        }
      }
    ]
  }
}
```