Adding a subscriber using Double-Opt-In (apiAddSubscriberDoi)

Use this function to add subscribers to a subscriber list. The subscriber must have a valid e-mail. Personalization fields can be passed (max 25), and for this purpose, the customFieldID and all relevant content must be transmitted. If an incorrect customFieldID is passed, personalization fields are not applied.

If a subscriber to be created is already present in the system, their personalization fields will be overwritten with the new values.

This function uses the double opt-in method. The given subscriber will receive an e-mail containing an activation link. Only after clicking this link is the subscriber added to the subscriber list. If this is not desired, apiAddSubscriber should 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 Example

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->apiAddSubscriberDoi(array('subscriberList'=>$subscriber));

}
catch (SoapFault $exception) {
 echo ($exception->getMessage());
}