Create a Subscriber

Create a new subscriber in a specific list by submitting their email and any additional custom fields. A confirmation email will be triggered based on the list configuration.

πŸ†• Create a Subscriber

Add a subscriber to your list with custom field data such as email, first name, and last name.


πŸ”Ή HTTP Request

POST API-URL/lists/LIST-UNIQUE-ID/subscribers

πŸ”Έ URL Segments

Segment
Required
Description

LIST-UNIQUE-ID

Yes

List unique identifier.


πŸ“€ POST Parameters

Parameter
Type
Required
Description

data

array

Yes

Associative array with custom fields. EMAIL is mandatory.


πŸ” Authorization Header

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

πŸ’» PHP Example

// ADD SUBSCRIBER
$response = $endpoint->create('LIST-UNIQUE-ID', [
    'EMAIL'    => '[email protected]', // the confirmation email will be sent!!! Use valid email address
    'FNAME'    => 'Linda',
    'LNAME'    => 'Smith'
]);

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

πŸ“¦ Sample JSON Response