Update a Subscriber by Email

Update the details of a subscriber by searching with their email address within a specific list. This method is ideal when the subscriber UID is not known in advance.

🔄 Update a Subscriber by Email

Search for a subscriber using their email, then update their details with a follow-up PUT request.

---

🔹 HTTP Request

Step 1: Search by email

GET API-URL/lists/LIST-UNIQUE-ID/subscribers/search-by-email

Step 2: Update using subscriber UID

PUT API-URL/lists/LIST-UNIQUE-ID/subscribers/SUBSCRIBER-UNIQUE-ID

---

🔸 URL Segments

Segment	Required	Description
LIST-UNIQUE-ID	Yes	List unique identifier
SUBSCRIBER-UNIQUE-ID	Yes	Subscriber UID returned from search

---

🔎 GET/PUT Parameters

Parameter	Type	Required	Description
EMAIL	string	Yes	Email address to search
data	array	Yes	Array of fields {name => value} to update

---

🔐 Authorization Header

X-API-KEY: your-api-key-here

---

💻 PHP Example

// UPDATE EXISTING SUBSCRIBER BY EMAIL
$response = $endpoint->updateByEmail('LIST-UNIQUE-ID', '[email protected]', [
    'EMAIL'    => '[email protected]',
    'FNAME'    => 'Emma',
    'LNAME'    => 'Woods Updated'
]);

// DISPLAY RESPONSE
echo '<hr />';
echo '<pre>';
print_r($response->body);
echo '</pre>';

---

📦 Sample JSON Response

{
  "status":"success",
  "data": {
    "record": {
      "subscriber_uid": "xy823cb90q812",
      "email": "[email protected]",
      "ip_address": "192.168.1.88",
      "source": "api",
      "date_added": "2025-04-17 14:30:42"
    }
  }
}