Remove people from a lead

Q: Which scope does this need?

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

POST/api/v1/leads/{id}/people/remove

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

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 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.