Create Subscribers in Bulk

Create multiple subscribers at once within a specific list using their email and any optional custom fields. Efficient for large list imports or API-driven syncs.

📥 Create Subscribers in Bulk

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

---

🔹 HTTP Request

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

// ADD SUBSCRIBERS IN BULK
$response = $endpoint->createBulk('LIST-UNIQUE-ID', [
    [
        'EMAIL'    => '[e-mail]',
        'FNAME'    => 'Alex',
        'LNAME'    => 'Doe'
    ],
    [
        'EMAIL'    => '[e-mail]',
        'FNAME'    => 'Mia',
        'LNAME'    => 'Stone'
    ],
    [
        'EMAIL'    => '[e-mail]',
        'FNAME'    => 'Noah',
        'LNAME'    => 'Lee'
    ]
]);

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

---

📦 Sample JSON Response

{
  "status":"success",
  "data": {
    "records": [
      {
        "data": {
          "subscriber_uid": "u1x9zr87yq45a",
          "EMAIL": "[e-mail]",
          "FNAME": "Alex",
          "LNAME": "Doe",
          "status": "confirmed",
          "source": "import",
          "ip_address": "",
          "date_added": "2025-04-17 14:22:10"
        }
      },
      {
        "data": {
          "subscriber_uid": "v3m0az21xp77k",
          "EMAIL": "[e-mail]",
          "FNAME": "Mia",
          "LNAME": "Stone",
          "status": "confirmed",
          "source": "import",
          "ip_address": "",
          "date_added": "2025-04-17 14:22:10"
        }
      },
      {
        "data": {
          "subscriber_uid": "n8k2bd54rw93m",
          "EMAIL": "[e-mail]",
          "FNAME": "Noah",
          "LNAME": "Lee",
          "status": "confirmed",
          "source": "import",
          "ip_address": "",
          "date_added": "2025-04-17 14:22:10"
        }
      }
    ]
  }
}