Update one subscriber who is already a member of a mailing list. Set their email address, confirmation status and optional custom fields. You can also specify 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>UpdateSubscriber</requestmethod>
   <details>
      <emailaddress>email@domain.com</emailaddress>
      <mailinglist>1</mailinglist>
      <format>html</format>
      <confirmed>yes</confirmed>
      <customfields>
         <item>
            <fieldid>1</fieldid>
            <value>John Smith</value>
            <fieldid>17</fieldid>
            <value>95050</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 for this 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 updated
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 set as unconfirmed.
format Use html to send user HTML emails or text for plain-text
tags (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 or updated
value Value of this custom field


Successful Response:


<response> element


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