Skip to main content
PUT
/
v1
/
leads
/
{leadId}
/
status
Update Lead Status
curl --request PUT \
  --url https://app-api.walead.ai/api/v1/leads/{leadId}/status \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "status": "waiting"
}
'
{
  "success": true,
  "message": "<string>",
  "leadId": "<string>",
  "status": "<string>"
}

​
Overview

Updates the status of a specific lead in your campaign. This allows you to manually change lead states based on your workflow or external triggers.

​
Available Statuses

Lead statuses control how the lead is processed in campaigns:
  • waiting - Lead is queued to be contacted
  • active - Lead is being actively contacted
  • paused - Lead processing is temporarily stopped
  • completed - Lead has completed the campaign sequence
  • error - An error occurred during processing

​
Use Cases

  • Pause outreach to specific leads
  • Mark leads as completed manually
  • Reset lead status after resolving issues
  • Integrate with external CRM systems

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate from your WaLead dashboard.

Path Parameters

​
leadId
string
required

Lead ID

Body

application/json

New lead status

​
status
enum<string>
required

New status for the lead

Available options:
waiting,
active,
paused,
completed,
error

Response

Lead status updated successfully

​
success
boolean
​
message
string
​
leadId
string
​
status
string