Write

Enroll Lead In Campaign

Enroll a contact in a campaign by its slug, creating the contact if it is new. Every call returns a complete verdict: added, already enrolled, or skipped with a reason. The operation is idempotent, so calling it repeatedly with the same input is always safe.

add_leadPOST/api/v1/leads

Get started View docs

crispy — bash

Example prompt: Enroll the contact john-doe in the gtm-engineers-apr26 campaign

{
  "verdict": "added",
  "crispy_id": "c_8f21",
  "campaign": "gtm-engineers-apr26"
}

Permission scope

core

Access

Write

What you can build

Add a freshly sourced prospect to an active outreach campaign

Bulk-enroll a list of contacts and read the per-call verdict for each

Re-run enrollment safely without worrying about duplicate entries

Create and enroll a brand-new contact in a single step with inline details

Parameters

Inputs accepted by add_lead.

Name	Type	Required	Description
campaign	`string`	required	Campaign slug (e.g. 'gtm-engineers-apr26'). Use list_campaigns to see available campaigns.
lookup	`object`	optional	Structured contact identifier. Resolver picks the highest-priority field per RESOLVER-09 (crispy_id > linkedin_provider_id > external_id > linkedin_url > email).
first_name	`string`	optional	First name (written on create if contact is new)
last_name	`string`	optional	Last name
email	`string`	optional	Email address
company	`string`	optional	Company name
title	`string`	optional	Job title
linkedin_url	`string`	optional	[Deprecated: use lookup.linkedin_url]

Related tools

Get Campaign Details

Fetch one LinkedIn campaign with state, stats, health, and outreach config, or list all campaigns. Parallel slice loading via the include parameter.

Add Or Update Lead

Add or update a LinkedIn lead by profile URL. Creates the contact if new, updates status, notes, tags, and custom attributes if it already exists.

Get Full Contact Picture

Get the complete LinkedIn contact picture in one call: identifiers, campaigns, messages, connection events, company, lead score, and next-best-action.

Search Saved Leads

Search your saved LinkedIn leads and contacts by name, status, tags, or company. Filter to new, contacted, replied, or qualified leads in one call.

Explore all Lead Management tools

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.

Connect your first profile

Read the docs