On this page

PATCH/campaigns/:campaignId/leads/:leadId

Update CRM fields on a lead. 0 credits. Rate class: patch_lead. Body must include at least one of tag, excluded.

Request

PATCH /campaigns/search-xyz/leads/lead_abc
X-API-Key: sk_live_...
Content-Type: application/json

{
  "tag": "Interested",
  "excluded": false
}

Field	Notes
`tag`	`null` / `""` clears; else one of the writable tags below
`excluded`	boolean

Interested, Not interested, Wrong person, Meeting booked, Resolved

This is a smaller set than the GET ?tag= filter allowlist (which also includes Information request, Meeting request, To be defined).

{
  "id": "lead_abc",
  "tag": "Interested",
  "excluded": false
}

Error code	When
`validation_error`	Empty body / unknown fields / invalid tag
`not_found`	Unknown campaign or lead

Tool: update_lead.