Add one or more subscribers to a preexisting mailing list. Set subscriber details email address, confirmation status and optional custom fields. You can specify whether to add that subscriber to autoresponders, whether they will receive HTML or text-based mailings, or if they should be tagged. 


XML Request Example:    

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
  <username>DRB-Test</username>
  <usertoken>a1de7f1e68e24201ad22a0cb166eee90c969237e</usertoken>
  <requesttype>Lists</requesttype>
  <requestmethod>AddSubscribersToList</requestmethod>
  <details>
    <list>{*list_id*}</list> <!-- a global or contact specific list-id is required for each contact -->
    <tag>{*tag_id or tag_name*}</tag>
    <tag>{*tag_id or tag_name*}</tag>
    <add_to_autoresponders>{*add_to_autoresponders_boolean*}</add_to_autoresponders>
    <update_if_exists>{*update_if_exists_boolean*}</update_if_exists>
    <contact> <!-- at least one required -->
      <email>{*email_address*}</email> <!-- required -->
      <list>{*list_id*}</list> <!-- a global or contact specific list-id is required for each contact -->
      <tag>{*tag_id or tag_name*}</tag>
      <tag>{*tag_id or tag_name*}</tag>
      <add_to_autoresponders>{*add_to_autoresponders_boolean*}</add_to_autoresponders>
      <send_confirmation>{*send_confirmation_boolean*}</send_confirmation>
      <format>{*email_format*}</format>
      <ipaddress>{*ip_address*}</ipaddress>
      <confirmed>{*confirmed_boolean*}</confirmed>
      <customfield>
        <fieldid>{*custom_field_id*}</fieldid>
        <value>{*custom_field_value*}</value>
      </customfield>
      <customfield>
        <fieldid>{*custom_field_id*}</fieldid>
        <value>{*custom_field_value*}</value>
      </customfield>
    </contact>
    <contact>
      <email>{*email_address*}</email> <!-- required -->
      <list>{*list_id*}</list> <!-- a global or contact specific list-id is required for each contact -->
      <tag>{*tag_id or tag_name*}</tag>
      <tag>{*tag_id or tag_name*}</tag>
      <add_to_autoresponders>{*add_to_autoresponders_boolean*}</add_to_autoresponders>
      <send_confirmation>{*send_confirmation_boolean*}</send_confirmation>
      <format>{*email_format*}</format>
      <ipaddress>{*ip_address*}</ipaddress>
      <confirmed>{*confirmed_boolean*}</confirmed>
      <customfield>
        <fieldid>{*custom_field_id*}</fieldid>
        <value>{*custom_field_value*}</value>
      </customfield>
      <customfield>
        <fieldid>{*custom_field_id*}</fieldid>
        <value>{*custom_field_value*}</value>
      </customfield>
    </contact>
	<return_data>{*return_data_boolean*}</return_data>
  </details>
</xmlrequest>
Null

 <xmlrequest> element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeName of API set to be used
requestmethodFunction being called


Please note: ALL OPTIONAL tags that are not used should be deleted from submitted call. For example, if no IP address will be supplied as part of the call, <ipaddress></ipaddress> should be deleted. 


<details> element 

Note: this section is to apply element values globally to all contacts for the API call. Corresponding element values entered as part of a contact-specific entry as described below will override these global values.  


Field NameDescription
list
(Required globally or per contact)
Add all contacts to this global database mailing list with this ID number who do NOT have a contact-specific list-ID assign to them. See "list" description below under <contacts> section. 
tag
(optional global tag assignment)
Use one or more elements to assign global tag_id(s) to all subscribers who do NOT have a contact-specific tag_id assigned to them. Values can be the tag's numeric ID or the tag name. See "tag" description below under <contacts> section. 
add_to_autoresponders
Globally adds all contacts to autoresponders, if they exist using true, 1 or yes.   If you do not wish to add contacts to autoresponders, enter a value of false, 0 or no. false is default. Individual contacts may also be added to autoresponders.  See "add_to_autoresponders" description below under <contacts> section. 
option_update_if_exists Set as true, 1 or yes to globally update all contacts' custom fields and tags. Default is false. If you attempt to update an existing contact field value without setting this to true, 1 or yes, system will throw an error. false is default. See "update_if_exists" description below under <contacts> section. 


<details>

<contact> element


Field NameDescription
emailemail address of contact to be added
list
(Required globally or per contact)
The list-ID of the database mailing list this specific contact should be added to. NOTE: contact-specific list-IDs will take precedence over the global list-ID specified under the global <details> section noted above. 
tag
(optional global tag assignment)
Use one or more elements to assign tag_id(s) to this specific contact. Values can be the tag's numeric ID or the tag name. NOTE: contact-specific tag_ids or tag_names will take precedence over the global tag_id or tag_name specified under the global <details> section noted above.  
add_to_autoresponders
Adds this specific contact to autoresponders, if they exist using true, 1 or yes   If you do not wish to add contact to autoresponders, enter a value of false, 0 or no. false is default. NOTE: This contact-specific value will take precedence over the global value if set above. 
formatUse html to send user HTML emails or text for plain-text. html is the default.
ipaddressCan add optional IP address.
confirmedUse true, 1 or yes to mark user as confirmed or false, 0 or no for unconfirmed. true is default


<customfield> OPTIONAL

<item> element - add values for a specific subscriber's custom fields. Use one item element pair per custom field.

NOTE: you may insert more than one pair of <customfield> tags to update multiple custom fields per subscriber added. 


Field NameDescription
fieldidID of custom field to be added.  
valueValue of this custom field

Please note: If no custom field data is to be sent, please delete the <customfield> tags and all inner tags to avoid a submission error. 


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if contact(s) was / were successfully added
dataContact ID number


Unsuccessful Response:


<response> element


Field NameDescription
statusWill return FAILED if unsuccessful
errormessageText explaining why request failed