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

Nutzen Sie diese Funktion um Empfänger in einer Empfängerliste anzulegen. Die Empfänger müssen eine gültige E-Mail besitzen. Es können Personalisierungsfelder übergeben werden, dafür muss die customFieldID und der entsprechende Inhalt übertragen werden. Wird eine falsche customFieldID übergeben werden keine Personalisierungsfelder angelegt.

Befindet sich ein neu anzulegender Empfänger bereits im System, so werden seine Personalisierungsfelder mit den neuen Werten überschrieben.

Diese Funktion verwendet das Double-Opt-In Verfahren. Der übergebene Empfänger wird eine E-Mail erhalten, die einen Aktivierungslink enthält. Erst nach Klick auf diesen Link wird der Empfänger an der Empfängerliste angemeldet. Wenn das nicht gewünscht wird, sollte apiAddSubscriber genutzt werden.

Request

Name	Type	Example	Required	Comment
subscriberList	subscriberList (50)	subscriberList		Pro Aufruf können maximal 50 Empfänger übertragen werden

Error Response

Code	Interpretation
204	Es wurden keine Empfänger übergeben.
404	Es wurde keine gültige Listen ID übergeben.
416	Es wurde eine ungültige E-Mailadresse übergeben.

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

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