Skip to main content
PATCH
/
v1
/
leads
/
{id}
/
status
curl -X PATCH https://api.sendpilot.ai/v1/leads/lead_abc123/status \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "OPPORTUNITY",
    "note": "Interested in enterprise plan"
  }'

{
  "success": true,
  "leadId": "lead_abc123",
  "status": "OPPORTUNITY",
  "message": "Lead status updated to 'OPPORTUNITY'"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sendpilot.ai/llms.txt

Use this file to discover all available pages before exploring further.

Manually update a lead’s status. This is useful for marking leads as opportunities or not interested based on external information.

​
Request

​
X-API-Key
string
required
Your API key
​
id
string
required
The lead ID
​
status
string
required
The new status for the lead. Options:
  • MEETING_BOOKED - Mark as meeting booked
  • OPPORTUNITY - Mark as a sales opportunity
  • NOT_INTERESTED - Mark as not interested
  • DONE - Mark as completed
​
note
string
Optional note to add to the lead’s history

​
Response

​
success
boolean
Whether the update was successful
​
leadId
string
Lead identifier
​
status
string
The new status
​
message
string
Confirmation message
curl -X PATCH https://api.sendpilot.ai/v1/leads/lead_abc123/status \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "OPPORTUNITY",
    "note": "Interested in enterprise plan"
  }'

{
  "success": true,
  "leadId": "lead_abc123",
  "status": "OPPORTUNITY",
  "message": "Lead status updated to 'OPPORTUNITY'"
}
When a lead’s status is updated, a lead.updated webhook event will be sent to your registered webhook endpoints.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Path Parameters

​
id
string
required

Lead ID

Body

application/json
​
status
enum<string>
required

New status for the lead

Available options:
PENDING,
CONNECTION_SENT,
CONNECTION_ACCEPTED,
MESSAGE_SENT,
REPLY_RECEIVED,
DONE
​
note
string

Optional note for the status change

Response

Lead status updated

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