Lead Associated Emails Add or Remove

POST

https://api.plusvibe.ai/api/v1/lead/associates/update

Add or remove associated emails on a lead. An associated email is another address the same person may reply from (a colleague, a personal address). Replies that arrive from an associated address are matched to this lead instead of landing in the Others (untracked) folder. The lead is found by workspace_id + email; add campaign_id to limit the change to one campaign, otherwise every campaign's copy of the lead in the workspace is updated. Works on leads of any status, including REPLIED. Addresses are stored lowercased; the lead's own email is ignored. The current list is returned, and is also visible as lead_data.associates on GET /lead/get.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successful

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.plusvibe.ai/api/v1/lead/associates/update' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workspace_id": "65f3c92d3dbe5dbb35374a9a",
    "campaign_id": "66b447598f6dd99f7f7b5c0a",
    "email": "lead@example.com",
    "add": [
        "colleague@example.com"
    ]
}'

Response Example

200 - Success Example

{
    "status": "success",
    "leads_updated": 1,
    "data": [
        {
            "lead_id": "6ae20352a4e9c138d36c0799",
            "campaign_id": "66b447598f6dd99f7f7b5c0a",
            "associates": [
                "colleague@example.com"
            ]
        }
    ]
}

Modified at 2026-11-11 04:39:30

Get lead counts by status

List all email accounts in the workspace