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'    => '[email protected]',
        'FNAME'    => 'Alex',
        'LNAME'    => 'Doe'
    ],
    [
        'EMAIL'    => '[email protected]',
        'FNAME'    => 'Mia',
        'LNAME'    => 'Stone'
    ],
    [
        'EMAIL'    => '[email protected]',
        'FNAME'    => 'Noah',
        'LNAME'    => 'Lee'
    ]
]);

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

๐Ÿ“ฆ Sample JSON Response