Save lead contacts
Add people to a lead or update the ones already saved, such as the founder from an intro call. A name alone is enough.
curl -X POST -H "Authorization: Bearer $REVNU_API_TOKEN" \
-H "content-type: application/json" \
-d '{"contacts":[{"name":"Akin Aydogan","email":"akin@micro-agi.com","title":"Operations"},{"name":"Rado"}]}' \
https://revnu.com/api/v1/leads/sn7…/contactsBody
{ "contacts": [ { "name"?, "email"?, "linkedinUrl"?, "title"?, "isPrimary"? } ] }: 1 to 20 people, each with a name, email or LinkedIn profile URL, text fields at most 300 characters. Any other field is a 400.
A person is matched to a saved contact by email, then LinkedIn profile, then name (including a contact saved with an email), and the fields you send update that contact. Anyone else is added. Someone saved with only a name can't be emailed or messaged by Revnu until an email or LinkedIn profile is added.
The lead's main contact changes only for the person marked isPrimary (at most one per call). When a lead's only contact so far is the one shown on the lead, that person stays the main contact as others are added.
Response
200 { "lead", "contacts" }. lead holds id, domain, companyName, status and contactCount; contacts lists only the people you sent, each with id, name, email, linkedinUrl, title, isPrimary and result (added or updated). Nobody is removed. A name that matches two saved contacts is a 409 asking for their email. 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.