PlusVibe.ai
  1. Lead
PlusVibe.ai
  • PlusVibe.ai API Documentation
  • Workspace
    • Get workspaces
      GET
    • Add a new workspace
      POST
  • Campaign
    • Create a new campaign
      POST
    • Create a new subsequence
      POST
    • List campaigns (deprecated)
      GET
    • List all campaigns
      GET
    • Get campaign name
      GET
    • Get campaign status
      GET
    • Get campaign email accounts
      GET
    • Get campaign emails
      GET
    • Set campaign name
      POST
    • Set campaign Schedules
      POST
    • Activate campaign
      POST
    • Pause campaign
      POST
  • Lead
    • Add leads to a campaign
      POST
    • Add leads to a subsequence campaign
      POST
    • Get or search for lead
      GET
    • Delete leads from a campaign
      POST
    • Lead Variable/Label Update or Add
      POST
    • Fetch workspace leads
      GET
    • Update the status of a lead
      POST
  • Email Account
    • List all email accounts in the workspace
      GET
    • Get email account status
      GET
    • Check account vitals
      POST
    • Enable Email account warmup
      POST
    • Pause Email account warmup
      POST
    • Delete Email account
      POST
    • Get Warmup Stats (Individual Account)
      GET
    • Get Warmup Stats (Workspace-Level)
      GET
    • Bulk Add SMTP Accounts
      POST
  • Analytics
    • Get campaign summary
    • Get campaign count (deprecated)
    • Get campaign stats
    • Get all campaigns statistics
  • Unibox
    • Get emails
    • Get count of unread emails
    • Reply to an email
    • Forward an existing email
    • Mark email read
  • Blocklist
    • Get entries in the blocklist
    • Adds entries to the blocklist
    • Delete entries in the blocklist
  • Webhook
    • PlusVibe Webhook Overview
    • Sample Payload - FIRST_EMAIL_REPLIES, ALL_EMAIL_REPLIES, ALL_POSITIVE_REPLIES
    • Sample Payload - LEAD_MARKED_AS_INTERESTED
    • Sample Payload - EMAIL_SENT
    • Add a new webhook
    • List webhooks
    • Delete webhook(s)
  • Tag
    • List Tags
  • For Email Infra Provider Partner
    • List workspaces
    • Initiate Google OAuth login flow
    • Initiate Microsoft OAuth login flow
    • Bulk Add SMTP Accounts (via Username and Password)
  1. Lead

Lead Variable/Label Update or Add

POST
https://api.plusvibe.ai/api/v1/lead/data/update
Lead
When using this endpoint, existing variables/label in the lead's data will be updated, and new variables provided in the variables property will be added to the lead's data.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.plusvibe.ai/api/v1/lead/data/update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workspace_id": "65f3c92d3dbe5dbb35374a9a",
    "campaign_id": "66b447598f6dd99f7f7b5c0a",
    "email": "lead@example.com",
    "variables": {
        "label": "NOT_INTERESTED",
        "first_name": "New First Name",
        "language": "Javascript",
        "interest": "Coding"
    }
}'
Response Response Example
200 - Example 1
{
    "status": "success"
}

Request

Header Params
x-api-key
string 
optional
Your PlusVibe.ai account's API Key
Default:
Example:
your-api-key
Body Params application/json
workspace_id
string 
required
Workspace ID
Example:
65f3c92d3dbe5dbb35374a9a
campaign_id
string 
required
The campaign ID of the lead to be updated
Example:
66b447598f6dd99f7f7b5c0a
email
string <email>
required
The email of the lead to be updated
Example:
lead@example.com
variables
object 
required
A key-value pair object containing the custom variables to be updated. Existing variables will be updated, and new variables will be added.
label
string 
optional
The label of the lead to be updated
Example:
NOT_INTERESTED
first_name
string 
optional
Example:
New First Name
language
string 
optional
Example:
Javascript
interest
string 
optional
Example:
Coding
Examples

Responses

🟢200OK
application/json
Successful
Body
status
string 
optional
Example:
success
🟠400Bad Request
🔴500Server Error
Modified at 2025-05-24 05:40:10
Previous
Delete leads from a campaign
Next
Fetch workspace leads
Built with