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.

Note:  This API call can also be found under the requesttype of "Lists".

XML Request Example:  

<?xml version="1.0" encoding="UTF-8"?>
    <email>{*email_address*}</email> <!-- required -->
    <list>{*list_id*}</list> <!-- required -->
    <tag>{*tag_id or tag_name*}</tag>
    <tag>{*tag_id or tag_name*}</tag>

Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account

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

Field NameDescription
Address of contact to be added.  
Add contact to the database mailing list with this ID number. 
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. false is default. 
Use true, 1 or yes to automatically send confirmation email to contact if <confirmed> tag set to false, 0 or no. Set <send_confirmation> to false, 0 or no if you do NOT want to send a confirmation email.
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. false is default.
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
Use one or more elements to assign tag(s) to this subscriber. Values can be the tag's numeric ID or the tag name.

<customfield> OPTIONAL

<item> element - add values for a 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. 

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. 

<return_data> and <include_membership> elements

Setting this element's value to true, 1 or yes results in the API call returning an expanded body of subscriber data required by some applications.
PieSync requirement: Setting this element's value to true, 1 or yes results in the API call adding a list of all tags that a subscriber is in as part of the returned information for that subscriber.

Successful Response:

<response> element

Field NameDescription
statusWill return SUCCESS if user was successfully added
dataContact ID number

Unsuccessful Response:

<response> element

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