Adding a subscriber (apiAddSubscriber)
Use this function to add subscribers into a subscriber list. The subscriber must have a valid e-mail. Personalization fields may be passed (max 25). For this, the customFieldID and all relevant content must be passed. If an incorrect customFieldID is passed, no personalization fields are applied.
If a subscriber to be created is already present in the system, their personalization fields will be overwritten with the new values.
If the double opt-in method is desired for logging in, apiAddSubscriberDoi must be used.
Request
Name | Type | Example | Required | Comment |
---|---|---|---|---|
subscriberList | subscriberList (50) | subscriberList | A maximum of 50 subscribers can be passed per call. |
Error Response
Code | Interpretation |
---|---|
204 | No subscribers were passed. |
404 | No valid list IDs were passed. |
416 | An invalid e-mail address was passed. |
PHP5 Beispiel
try{ $subscriber[0] = array( 'listID' => '123456789', 'email' => 'mustermann@test.de', 'customFields' => array( 0 => array( 'customFieldID' => '12345', 'customFieldValue' => 'Herr' ), 1 => array( 'customFieldID' => '12346', 'customFieldValue' => 'Dr.' ), 2 => array( 'customFieldID' => '123457', 'customFieldValue' => 'Max' ), 3 => array( 'customFieldID' => '123458', 'customFieldValue' => 'Mustermann' ), ) ); $response=$client->apiAddSubscriber(array('subscriberList'=>$subscriber)); } catch (SoapFault $exception) { echo ($exception->getMessage()); }