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.
PLEASE NOTE: THIS METHOD CAN BE USED TO UPDATE AN EXISTING CONTACT'S EMAIL ADDRESS BUT WILL NOT MODIFY THE SUBSCRIBER ID.
Note: This API call can also be found under the requesttype of "Lists".
JSON Request Example:
"json_request" element
Field Name | Description |
username | Username used to login to Pinpointe |
usertoken | Unique token for this Pinpointe account |
requesttype | Subscribers |
requestmethod | UpdateSubscriber |
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 Name | Description |
email (Required) | Email address of contact to be updated |
list (Required) | List id of list contact belongs to. |
newemail (Optional) | New email to use for subscriber |
tag (Optional) | tag is or tag name subscriber is to be added to. Can specify more than one. |
format (Optional) | Use html to send user HTML emails or text for plain-text |
ipaddress (Optional) | new IP address of subscriber |
confirmed (Optional) | Use true, 1 or yes to mark an unconfirmed contact as "confirmed". Setting the value to false, 0 or no, or simply deleting the tag before submitting the call will not change an unconfirmed status. User may NOT change a confirmed contact to unconfirmed status. |
timezone (optional) | Will accept US / Canadian time zones as local-specified (e.g. America/Los_Angeles) OR any of the US or Canadian short codes: EST, EDT, CST, CDT, MST, MDT, PST, PDT, etc. OR an offset from GMT/UTC. |
"customfield" Note: Can use more than one set of "customfield" element. OPTIONAL
"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 |
"return_data" and "include_membership" elements
return_data | 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. |
include_membership | 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 Name | Description |
status | Will return SUCCESS if user was successfully updated |
data | Contact ID number |
Unsuccessful Response:
"response" element
Field Name | Description |
status | Will return FAILED if unsuccessful |
errormessage | Text explaining why request failed |