ACTION_ID: lemlist_add_lead_to_campaign
NAME: Lemlist: Add leads to a campaign
CATEGORY: Outreach
CREDITS: 0

Add a lead to a campaign in Lemlist.

PREREQUISITE: Lemlist account connection — the user must create it in the Floqer UI
(Connections page); an agent cannot. Without it the action fails the row with
a connection / authentication error. Confirm it exists before configuring.

1. INPUTS

campaigns (dynamicDropdown, required)
  Campaigns. The campaigns to add the lead to. Values from the
  lemlist list.

email (email, required)
  Email. The email of the lead.

first_name (string, optional)
  First Name.

last_name (string, optional)
  Last Name.

company_name (string, optional)
  Company Name.

ice_breaker_text (string, optional)
  Ice Breaker Text. Icebreaker text of the lead.

phone_number (string, optional)
  Phone Number.

picture_url (imageUrl, optional)
  Picture URL.

linkedin_url (url, optional)
  LinkedIn URL.

company_domain (url, optional)
  Company Domain.

custom_variables (jsonArray, optional)
  Custom Variables.

2. OUTPUTS

status (string) — Status. e.g. "completed".

3. HOW TO CONFIGURE

Resolve the campaign list via Get Action Field Options:

  POST /api/v1/workflows/{workflow_id}/sheets/{sheet_id}/actions/{action_instance_id}/options/campaigns
       (body: {})

Configure Action body:

{
  "inputs": {
    "campaigns": "<lemlist_campaign_id>",
    "email": "{{input.email}}",
    "first_name": "{{input.first_name}}",
    "last_name": "{{input.last_name}}",
    "company_name": "{{input.company_name}}",
    "linkedin_url": "{{input.linkedin_url}}",
    "company_domain": "{{input.company_domain}}",
    "ice_breaker_text": "{{llm_models_1.generated_content}}",
    "custom_variables": [
      { "name": "industry", "value": "{{input.industry}}" }
    ]
  }
}

Field-by-field:
  - campaigns          Lemlist campaign ID from the `campaigns`
                       options call.
  - email              Lead's email — required.
  - first_name / last_name /
    company_name /
    phone_number / picture_url /
    linkedin_url /
    company_domain     Optional lead profile fields.
  - ice_breaker_text   Per-lead opener text rendered into the
                       Lemlist email template — common slot for
                       AI-generated content from upstream `llm_models`.
  - custom_variables   `[{name, value}]` for custom merge tags
                       referenced in the campaign template.

4. KEY NOTES

- `ice_breaker_text` and `custom_variables` are the slots for
  AI-generated per-lead content. Each `name` in `custom_variables`
  must match a `{{custom_variable}}` placeholder in the Lemlist
  campaign template.

5. WHERE IT FITS IN A WORKFLOW

Pattern: contact discovery -> person_work_email_waterfall ->
person_work_email_verification_by_* -> llm_models ->
lemlist_add_lead_to_campaign.

6. WHEN TO USE

Use lemlist_add_lead_to_campaign to enroll leads in Lemlist
campaigns.

7. WHEN NOT TO USE

Need a different sender (Instantly, Smartlead, La Growth Machine,
Reply, HeyReach)
  -> instantly_add_to_campaign, smartleads_add_to_campaign,
     la_growth_machine_add_to_audience,
     reply_add_and_push_to_campaign,
     heyreach_add_leads_to_campaign
     (https://floqer.com/docs/action-detail/<action_id>.txt)

Need AI-generated email content
  -> llm_models (upstream of this action; pass the generated content
     via `ice_breaker_text` or `custom_variables`)
     (https://floqer.com/docs/action-detail/llm_models.txt)

Last updated: 2026-04-30.