# Remove people from a lead

> Take wrong people off a lead's researched people, such as a namesake at another company. Saved contacts are kept and reported back.

Canonical: https://revnu.com/docs/lead-people-remove
Last updated: 2026-10-30

```bash
curl -X POST -H "Authorization: Bearer $REVNU_API_TOKEN" \
  -H "content-type: application/json" \
  -d '{"people":[{"linkedinUrl":"https://www.linkedin.com/in/dana-wrong"}]}' \
  https://revnu.com/api/v1/leads/sn7…/people/remove
```

## Body

`{ "people": [ { "name"?, "email"?, "linkedinUrl"? } ] }`: up to 20 people, each with at least one field, at most 300 characters each. A LinkedIn URL or email matches exactly; a name alone matches only when one person has it. Any other field is a `400`.

## Response

`200 { "domain", "removed", "kept" }`. `removed` lists the names taken off. `kept` lists each person left on the lead with the reason: not on this lead, more than one match, or a saved contact. A saved contact has its own outreach history, so it stays; [block](https://revnu.com/docs/blocklist-add.md) the address to stop outreach to them. `404` for an unknown or another account's lead.

## Frequently asked questions

### Which scope does this need?

`leads:write`. A token without it gets `403` with `requiredScope` in the body.