Hand a lead back
DELETE/api/v1/leads/{id}/handling
Give a lead your team took over back to Revnu, which may then contact the company again under your approval settings.
curl -X DELETE -H "Authorization: Bearer $REVNU_API_TOKEN" \
https://revnu.com/api/v1/leads/sn7…/handlingResponse
200 { "domain", "handedBack" }. handedBack is false when nobody on your team had the lead. 404 for an unknown or another account's lead.
Frequently Asked Questions
Does Revnu email them straight away?
No. Emails cancelled when the lead was taken over are not re-queued. Revnu may contact the company again on its next pass, under your normal approvals.
What if the company is on the block list?
It stays blocked. Handing a lead back doesn't lift a block; remove the entry for that.
Which scope does this need?
leads:write. A token without it gets 403 with requiredScope in the body.