> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Lemlist

> This page outlines how to use the Lemlist integration for sales outreach and email campaigns in Cargo.

Lemlist is a sales engagement platform that helps teams send personalized cold emails at scale with automated follow-ups and advanced personalization. Cargo's native integration with Lemlist allows you to manage leads, campaigns, and email activities directly from your workflows.

## How to set up Lemlist

To connect Lemlist, you'll need an API key from your Lemlist account.

### Connection details

| Field       | Description          |
| ----------- | -------------------- |
| **API Key** | Your Lemlist API key |

<Tip>Find your API key in Lemlist under **Settings → Integrations → API**.</Tip>

Once the connector is created, you can:

* **Set up Lemlist data models** — Create data models from your Lemlist leads and activities to trigger Plays.
* **Use Lemlist in workflows** — Choose **Lemlist** from the node catalog within a **Play**, **Tool**, or **Agent**.

***

## Lemlist actions

### Create Lead

Create a new lead in a Lemlist campaign.

**Use cases**

* **Campaign enrollment** – Add qualified leads to outreach campaigns
* **List building** – Push leads from various sources to Lemlist
* **Multi-channel sequences** – Enroll leads in email sequences

**Configuration**

| Field        | Description                               |
| ------------ | ----------------------------------------- |
| **Campaign** | Select the campaign to add the lead to    |
| **Email**    | The lead's email address                  |
| **Mappings** | Map additional lead attributes            |
| **Options**  | Additional processing options (see below) |

**Available options**

| Option                  | Description                                    |
| ----------------------- | ---------------------------------------------- |
| **Deduplicate**         | Check if email exists in other campaigns first |
| **Find email**          | Use Lemlist to find verified email             |
| **LinkedIn enrichment** | Run LinkedIn enrichment on the lead            |
| **Verify email**        | Verify the existing email address              |

<Info>
  When creating leads with the **Deduplicate** option, Lemlist will check all
  campaigns to prevent adding the same email twice.
</Info>

### Update Lead

Update an existing lead in a campaign.

**Use cases**

* **Data enrichment** – Update leads with enriched data
* **Status updates** – Update lead information based on external events
* **Field updates** – Sync lead data from other systems

**Configuration**

| Field        | Description                             |
| ------------ | --------------------------------------- |
| **Campaign** | Select the campaign containing the lead |
| **Email**    | The lead's email address to match       |
| **Mappings** | Map lead attributes to update           |

### Upsert Lead

Create a new lead or update an existing one.

**Use cases**

* **Data sync** – Sync leads from your CRM without duplicates
* **Idempotent operations** – Safely retry lead creation
* **Continuous enrollment** – Keep leads updated as data changes

**Configuration**

| Field        | Description                |
| ------------ | -------------------------- |
| **Campaign** | Select the target campaign |
| **Email**    | The lead's email address   |
| **Mappings** | Map lead attributes        |

### Delete Lead

Remove a lead from a campaign.

**Use cases**

* **Campaign cleanup** – Remove invalid leads
* **Unsubscribe handling** – Remove leads who opted out
* **Lead management** – Remove leads that no longer qualify

**Configuration**

| Field        | Description                             |
| ------------ | --------------------------------------- |
| **Campaign** | Select the campaign containing the lead |
| **Email**    | The lead's email address to remove      |

### Get Lead

Retrieve lead information by ID or email.

**Use cases**

* **Lead lookup** – Fetch lead data for workflow conditions
* **Status check** – Check lead status before taking action

**Configuration**

| Field  | Description              |
| ------ | ------------------------ |
| **ID** | Lead ID or email address |

### Get Campaign

Retrieve campaign information by ID.

**Configuration**

| Field  | Description |
| ------ | ----------- |
| **ID** | Campaign ID |

### Unsubscribe Lead from Campaign

Remove a lead from a specific campaign's sequence.

**Use cases**

* **Opt-out handling** – Stop sequences for specific campaigns
* **Campaign management** – Remove leads from specific outreach

**Configuration**

| Field        | Description              |
| ------------ | ------------------------ |
| **Campaign** | Select the campaign      |
| **Email**    | The lead's email address |

### Add unsubscribe email

Add an email to the global unsubscribe list.

**Use cases**

* **Global opt-out** – Prevent all future emails to an address
* **GDPR compliance** – Honor unsubscribe requests

**Configuration**

| Field     | Description                      |
| --------- | -------------------------------- |
| **Email** | The email address to unsubscribe |

<Warning>
  Adding an email to the unsubscribe list will prevent it from receiving emails
  across all campaigns.
</Warning>

### Delete unsubscribe email

Remove an email from the global unsubscribe list.

**Use cases**

* **Re-subscription** – Allow a previously unsubscribed email to receive emails
* **Error correction** – Fix accidental unsubscribes

**Configuration**

| Field     | Description                                  |
| --------- | -------------------------------------------- |
| **Email** | The email address to remove from unsubscribe |

***

## Lemlist data models

Cargo allows you to create data models on top of your Lemlist data that can be used to trigger Plays and power workflows.

### Available extractors

<AccordionGroup>
  <Accordion title="Fetch leads" icon="users">
    Pull lead records from Lemlist with incremental sync support. **Use cases**

    * Build data models from your Lemlist leads - Trigger workflows when leads
      are added or updated - Sync lead data back to your CRM
  </Accordion>

  <Accordion title="Fetch campaigns" icon="paper-plane">
    Pull campaign records from Lemlist. **Use cases** - Track campaign status
    and settings - Monitor campaign performance
  </Accordion>

  <Accordion title="Fetch activities" icon="chart-line">
    Pull activity events from Lemlist including opens, clicks, and replies.
    **Use cases** - Track email engagement - Trigger workflows on email opens or
    replies - Monitor campaign performance
  </Accordion>

  <Accordion title="Fetch unsubscribes" icon="ban">
    Pull the global unsubscribe list. **Use cases** - Sync unsubscribes to other
    systems - Maintain compliance records
  </Accordion>
</AccordionGroup>