Reject a lead
Mark a lead as rejected so Lancer never bids on it.
POST /v1/campaigns/:campaignId/leads/:leadId/rejectMarks the lead as rejected. Lancer will not bid on it, and in external mode this closes the loop on a job.new delivery you decided to pass on. Rejections show up in the campaign's Feed and Activity tabs, with your reason if you provide one.
Request body
The body is optional.
| Field | Type | Required | Notes |
|---|---|---|---|
reason | string | no | Why you passed, up to 500 characters. Shown in the web app. |
Example
curl -X POST \
"https://api.lancer.app/v1/campaigns/CAMPAIGN_ID/leads/LEAD_ID/reject" \
-H "Authorization: Bearer lk_..." \
-H "Content-Type: application/json" \
-d '{ "reason": "Budget below our minimum" }'Response
{
"success": true,
"leadId": "lead_abc123",
"campaignId": "cmp_123",
"organizationId": "org_123"
}Errors
| Status | When |
|---|---|
401 | Missing or invalid key, or the subscription is inactive. |
404 | Lead not found. |