Add a lead to a campaign

Add a lead to a campaign

Creates a lead in a lemlist campaign from an email, name, company and custom variables, optionally finding or verifying their email first; it never updates an existing lead.

Replace {campaignId} with the campaign's id (cam_...). A contact that is already in the campaign is refused with 400 LEAD_ALREADY_IN_CAMPAIGN; set deduplicate=true to also refuse contacts that are in another campaign. findEmail, verifyEmail, findPhone and linkedinEnrichment spend credits. A campaign automates outreach to its leads, so confirm the campaign before adding people to it.

Set up

Use the first option your agent supports.

CLI (official)

Install the command, then confirm it runs.

npm install -g @lemlist-official/cli
lemlist --version

Run lemlist api POST /campaigns/{campaignId}/leads/.

API (official)

• Base URL: https://api.lemlist.com/api
• Endpoint: POST /campaigns/{campaignId}/leads/
• Auth: send the header Authorization: Basic $LEMLIST_API_KEY
• Get a key: https://app.lemlist.com/settings/integrations
• Docs: https://developer.lemlist.com/api-reference/getting-started/authentication

Before doing anything else, make one read-only call to confirm access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data.
• Never print API keys.