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

Update the status of a lead

POST
https://api.plusvibe.ai/api/v1/lead/update/status
Lead
Updates the status of a lead in the specified campaign and workspace. Only new_status set to COMPLETED is accepted.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.plusvibe.ai/api/v1/lead/update/status' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workspace_id": "65099a0dd96fae8ab61130c0",
    "campaign_id": "67838580ef4b6f32e67e7dfc",
    "email": "notcontacted@plusvibe.ai",
    "new_status": "COMPLETED"
}'
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
The ID of the workspace containing the campaign.
Example:
65099a0dd96fae8ab61130c0
campaign_id
string 
required
The ID of the campaign to which the lead belongs.
Example:
67838580ef4b6f32e67e7dfc
email
string 
required
The email address of the lead whose status is being updated.
Example:
notcontacted@plusvibe.ai
new_status
string 
required
The new status for the lead. Only COMPLETED is accepted.
Example:
COMPLETED
Examples

Responses

🟢200OK
application/json
Successful update of the lead status.
Body
status
string 
optional
The status of the request.
Example:
success
🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Modified at 2025-05-24 05:40:10
Previous
Fetch workspace leads
Next
List all email accounts in the workspace
Built with