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.

JSON Request Example:     

{
  "username": "DRB-Test",
  "usertoken": "a1de7f1e68e24201ad22a0cb166eee90c969237e",
  "requesttype": "Lists",
  "requestmethod": "UpdateSubscriber",
  "details": {
    "email": "{*email_address*}", /* required */
    "list": "{*list_id*}", /* required */
    "newemail": "{*new_email_address*}",
    "tag": ["{*tag_id or tag_name*}", "{*tag_id or tag_name*}"],
    "format": "{*email_format*}",
    "ipaddress": "{*ip_address*}",
    "confirmed": "{*confirmed_boolean*}",
    "customfield":
    [
      {
        "fieldid": "{*custom_field_id*}",
        "value": "{*custom_field_value*}"
      },
      {
        "fieldid": "{*custom_field_id*}",
        "value": "{*custom_field_value*}"
      }
    ],
    "return_data": "{*return_data_boolean*}",
    "include_membership": "{*include_membership_boolean*}"
  }
}

 "json_request" element 

Please note: ALL OPTIONAL elements 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": "{*ip_address*}", should be deleted.  

"details" element

"customfield" OPTIONAL 

"fieldid", "value" elements - add values for a subscriber's custom fields. Use one "fieldid" and "value" pair per custom field. 

NOTE: you may insert multiple "fieldid" and "value" pair elements to update multiple custom fields.  

Successful Response:

"response" element

Unsuccessful Response:

"response" element