Add one subscriber to a pre-existing mailing list. Set subscriber details email address, confirmation status and optional custom fields. You can specify whether to add that subscriber to autoresponders and whether they will receive HTML or text-based mailings.


XML Request Example:    

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
  <username>username@yourcompany.com</username>
  <usertoken>get-token-from-support</usertoken>
  <requesttype>Lists</requesttype>
  <requestmethod>AddSubscriberToList</requestmethod>
  <details>
      <email>{email_address}</email> <!-- required -->
      <list>{list_id}</list> <!-- required -->
      <add_to_autoresponders>{add_to_autoresponders_boolean}</add_to_autoresponders> <!-- required -->
      <option_update_if_exists>{update_if_exists_boolean}</option_update_if_exists> <!-- required -->
      <format>{email_format}</format>
      <ipaddress>{ip_address}</ipaddress>
      <confirmed>{confirmed_boolean}</confirmed>
      <send_confirmation>{send_confirmation_boolean}</send_confirmation> 
      <tag>{tag_id}</tag>
      <tag>{tag_id}</tag>
      <customfield>
           <fieldid>{custom_field_id}</fieldid>
           <value>{custom_field_value}</value>
      </customfield>
      <customfield>
           <fieldid>{custom_field_id}</fieldid>
           <value>{custom_field_value}</value>
      </customfield>
  </details>
</xmlrequest>

 <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


<details> element


Field NameDescription
email
(Required)
Address of contact to be added.  
list
(Required)
Add contact to the database mailing list with this ID number. 
add_to_autoresponders
Adds 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.
option_update_if_exists Set as true, 1 or yes to update contact 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.
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.
send_confirmation
Use true, 1 or yes to send confirmation email if confirmed is false, 0 or no.
tag (optional)
Use one or more elements to assign tags to this subscriber. Values can be the tag's numeric ID or the tag name.


<customfield>

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


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 user was successfully added
dataContact ID number