listAddContactsRetID
public static array listAddContactsRetID(string token, string listID, array contacts)
Add the contact details to the given contact list. Multiple contacts would be added if the details has more than one items.
Section
Contact List Related Methods

Parameters
string tokenA valid token for your account. To generate a token, use the login method.
string listIDThe contact list ID in which to add contacts. To get all the contact lists, use the listGet method.
array contactsThe array containing the contact details.
string emailThe email address
string firstnameThe First Name of the contact
string lastnameThe Last Name of the contact
string optinOptional. "1" - will send a confirmation email before adding the contact to the list.

Returns
arrayReturns the contact structure with id and email


Examples
download example code
xmlrpc_listAddContactsRetID.php


  1. <?php
  2. /**
  3. This Example shows how to authenticate a user using XML-RPC.
  4. Note that we are using the PEAR XML-RPC client and recommend others do as well.
  5. **/
  6. require_once 'XML/RPC2/Client.php';
  7. require_once 'inc/config.php';
  8. $client = XML_RPC2_Client::create($apiURL);
  9. $token = $client->login($apiLogin, $apiPassword);
  10.  
  11. /**
  12. Fetch the latest contact list, so we can retrieve the contact list ID.
  13. **/
  14. $contactList = $client->listGet($token, "", 1, 1, "", "");
  15. $listID = $contactList[0]['id'];
  16. /**
  17. Set optin to 1 incase you want to send a confirmation link
  18. **/
  19. $optin = "0";
  20.  
  21. /**
  22. Prepare the data to insert.
  23. **/
  24. $record1['email'] = "user1@___.com";
  25. $record1['firstname'] = 'Peter';
  26. $record1['lastname'] = 'Parker';
  27.  
  28. $record2['email'] = "user2@___.com";
  29. $record2['firstname'] = 'Bruce';
  30. $record2['lastname'] = 'Banner';
  31.  
  32. $rec = array($record1, $record2);
  33.  
  34. $added = $client->listAddContactsRetID($token, $listID, $rec);
  35.  
  36. echo $added . " records added.";
  37. ?>