On this page

PATCH/campaigns/:campaignId/leads/:leadId

Credits: 0
LinkedIn risk: None
Rate limit: 60 / minute

Purpose

Set inbox tag and/or excluded. Provide at least one field.

PATCH /campaigns/search_abc/leads/lead_xyz
X-API-Key: sk_live_...
Content-Type: application/json

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

Field	Notes
`tag`	Exact label below, or `null` to clear
`excluded`	boolean

At least one of tag / excluded. Unknown keys → 400 validation_error.

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

May emit webhook lead.tagged. Setting or changing tag updates taggedAt on list leads / get lead. Unknown tag → 400 validation_error.

For many leads, prefer batch-update (immediate exclude; no pending acknowledgement deferral).

`error.code`	When
`unauthorized`	Missing/invalid API key
`validation_error`	Unknown tag / neither field / unknown keys
`not_found`	Unknown campaign or lead
`rate_limited`	60/min or global RPM

Tool: update_lead. For bulk tag/exclude use update_leads_batch.