Add subscribers based on subscriber ID to a new or existing tag.


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


XML Request Example:    

<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
  <username>JohnDoe</username>
  <usertoken>abc123abc123abc123abc123</usertoken>
  <requesttype>Tags</requesttype>
  <requestmethod>TagSubscribers</requestmethod>
  <details>
    <tag>{*tag_id or tag_name*}</tag> <!-- required -->
    <tag>{*tag_id or tag_name*}</tag>
    <subscriberid>{*subscriber_id*}</subscriberid> <!-- required -->
    <subscriberid>{*subscriber_id*}</subscriberid>
  </details>
</xmlrequest>

<xmlrequest> element


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


Please note: ALL OPTIONAL tags that are not used should be deleted from submitted call. if only one <tag></tag> and / or <subscriberid></subscriberid> element is/are being used, remove all unused elements.


<details> element

<tag>


Field NameDescription
tag
(Required)
ID of tag to be searched. At least one required.  
subscriberid
ID of subscriber being added to tag. At least one required.


Successful Response:


<response> element


Field NameDescription
statusWill return SUCCESS if contact(s) were successfully added to the tag(s).
dataTag count contact(s) were added to


Unsuccessful Response:


<response> element


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