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>2</fieldid>
      <value>Bob</value>
    </item>
    <item>
      <fieldid>3</fieldid>
      <value>Jones</value>
    </item>
  </customfields>
      <tag>25</tag>
      <tag>Tag Name</tag>
   </details>
</xmlrequest>

  <xmlrequest> element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token for this Pinpointe account
requesttypeName of API set to be used
requestmethodFunction being called


<details> element


Field NameDescription
emailaddressAddress of contact to be updated
mailinglistidAdd 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.
formatUse 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 NameDescription
fieldidID of custom field to be added or updated
valueValue of this custom field


Successful Response:


<response> element


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