Adding a subscriber (apiAddSubscriber)

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.

Wenn das Double-Opt-In Verfahren bei der Anmeldung gewünscht ist, muss apiAddSubscriberDoi benutzt 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->apiAddSubscriber(array('subscriberList'=>$subscriber));

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