Skip to main content
POST
Add Leads to Campaign
CLI:

Overview

Bulk-insert leads into a draft campaign. Deduplicates by email (email campaigns) or linkedin_url (LinkedIn campaigns) — both within the batch and against existing rows. Identity is normalized (lowercased email; LinkedIn URLs stripped of trailing slashes and query strings). Only draft campaigns accept new leads. After insert, campaigns.stats is recomputed atomically.
This operation shares the URL path /api/campaigns/{id}/leads with other verbs. See the sibling page for related operations on the same resource.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Campaign UUID

Body

application/json
prospects
object[]
required
Required array length: 1 - 1000 elements

Response

Leads imported successfully.

imported
integer
required
Required range: 0 <= x <= 9007199254740991
duplicates
integer
required
Required range: 0 <= x <= 9007199254740991