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

Add a lead to a campaign in Lemlist.

================================================================================
PREREQUISITE — USER ACTION REQUIRED
================================================================================

This action only works if the user has connected their Lemlist account
in Floqer. The connection cannot be made via the API or by an AI agent.

The user must do this themselves before this action will run:
  1. Sign in to Floqer at https://app.floqer.com
  2. Open the Connections page from the sidebar
  3. Click Lemlist and complete the OAuth flow

If the user has not connected Lemlist, this action will fail with a
connection / authentication error. Before configuring or running this
action, confirm with the user that the Lemlist connection exists.

INDEX:
  1. Inputs
  2. Outputs
  3. How to configure
  4. Key notes
  5. Where it fits in a workflow
  6. When to use
  7. When not to use

================================================================================
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)

================================================================================

This file is maintained manually. Last updated: 2026-04-30.
Full interactive reference: https://floqer.com/docs/reference
Action catalog: https://floqer.com/docs/action-catalog.txt