Skip to main content
POST
Create a lead extraction campaign
Requires lead_sourcing:run and the creator’s ALLOW_LEAD_EXTRACTION workspace permission. Supply name, HTTPS search urls, url_type, mode, and limit.
  • url_type: linkedin_search or sales_navigator.
  • mode: extraction_only or with_enrichment.
  • limit: at least 1; REST is capped by available credits rather than MCP’s separate 2,000-lead tool maximum.
  • webhook_url: optional public HTTPS completion destination.
Extraction costs 1 credit per lead. The response’s id identifies the extraction job. Despite the URL’s campaigns segment, this does not create an outreach sequence. Poll job status, then read its leads. Use an Idempotency-Key to avoid duplicate paid jobs on retries.

Authorizations

X-API-Key
string
header
required

API key for authentication (prefix: sp_live_ or sp_test_)

Body

application/json
name
string
required

Campaign name

urls
string[]
required

Search URLs (LinkedIn or Sales Navigator). Must be HTTPS.

url_type
enum<string>
required

Type of URLs provided

Available options:
linkedin_search,
sales_navigator
mode
enum<string>
required

Extraction mode

Available options:
extraction_only,
with_enrichment
limit
number
required

Maximum leads to extract (no hard limit - capped by available credits)

Required range: x >= 1
webhook_url
string

HTTPS URL to receive a completion notification. Must be a public host.

Example:

"https://my-app.example.com/webhooks/sendpilot"

Response

Campaign created successfully

id
string
required
name
string
required
status
string
required
created_at
string
required
estimated_credits
number
required

Estimated credits to be consumed