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

{
  "id": "lead_abc123",
  "linkedinUrl": "https://www.linkedin.com/in/john-doe",
  "previousStatus": "REPLY_RECEIVED",
  "status": "OPPORTUNITY",
  "updatedAt": "2024-02-24T15:30:00.000Z"
}
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
​
leadId
string
required
The lead ID
​
status
string
required
The new status for the lead. Options:
  • OPPORTUNITY - Mark as a sales opportunity
  • NOT_INTERESTED - Mark as not interested
  • DONE - Mark as completed

​
Response

​
id
string
Lead identifier
​
linkedinUrl
string
LinkedIn profile URL
​
previousStatus
string
The status before this update
​
status
string
The new status
​
updatedAt
string
ISO 8601 timestamp of the update
curl -X PATCH https://api.sendpilot.ai/api/v1/leads/lead_abc123/status \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "OPPORTUNITY"
  }'

{
  "id": "lead_abc123",
  "linkedinUrl": "https://www.linkedin.com/in/john-doe",
  "previousStatus": "REPLY_RECEIVED",
  "status": "OPPORTUNITY",
  "updatedAt": "2024-02-24T15:30:00.000Z"
}
When a lead’s status is updated, a lead.status.changed webhook event will be sent to your registered webhook endpoints.