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>admin</username>
   <usertoken>abc123abc123abc123abc123abc123abc123abc123abc123</usertoken>
   <requesttype>subscribers</requesttype>
   <requestmethod>AddSubscriberToList</requestmethod>
   <details>
      <emailaddress>email@domain.com</emailaddress>
      <add_to_autoresponders>true</add_to_autoresponders>
      <mailinglist>1</mailinglist>
      <format>html</format>
      <confirmed>yes</confirmed>
      <customfields>
         <item>
            <fieldid>1</fieldid>
            <value>John Smith</value>
         </item>
      </customfields>
      <tag>25</tag>
      <tag>Tag Name</tag>
   </details>
</xmlrequest>

 <xmlrequest> element


Field Name Description
username Username used to login to Pinpointe
usertoken Unique token assigned to Pinpointe account
requesttype Name of API set to be used
requestmethod Function being called


<details> element


Field Name Description
emailaddress Address of contact to be added
add_to_autoresponders (optional) Adds contact to autoresponders, if they exist. Do not include <add_to_autoresponders> element if you do not wish to add contact to autoresponders.
mailinglistid Add contact to the mailing list with this ID number
confirmed (optional) Use <confirmed>yes</confirmed> to mark user as confirmed. Do not include this XML element to leave user unconfirmed.
format

Use html to send user HTML emails or text for plain-text

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.


<customfields>

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


Field Name Description
fieldid ID of custom field to be added
value Value of this custom field


Successful Response:


<response> element


Field Name Description
status Will return SUCCESS if user was successfully added
data Contact ID number