Create a lead
Creates a lead, or adds an existing lead to the requested lists. When an email matches a lead already on your team, the request is additive: it adds only the missing list memberships and returns 201 rather than an email duplicate error. When the matched lead belongs to a teammate, the request still adds it to your lists, and the teammate's lead itself is only updated if you have permission to edit it. A request without an email is never matched by email — it does not reuse an existing email-less lead — though a lead with an identical name, company, and list is still rejected as a duplicate.
Accepts department since HUN-23171, normalized to its canonical key so a localized display label ("Sales") is stored as sales. Lead attributes are not modelled field-by-field in this contract yet — the response uses the generic resource envelope — so this note is where the accepted set is recorded.
When another request is creating leads for the team, returns 409 with lead_creation_in_progress and Retry-After: 1. Retry the request after one second.
Request
- Base URL: https://api.hunter.io/v2
- URL: https://api.hunter.io/v2/leads
- Auth: one of:
- API key in query parameter api_key
- API key in header X-API-KEY
- HTTP bearer
Response
Create a lead.
Generic envelope for V2 resource operations whose detailed schema is not yet in the contract.
Changes
No recorded changes to this operation across all 1 revision of this API.