# lemlist app URL: https://attio.com/help/reference/apps/data-and-enrichment-apps/lemlist-app Breadcrumbs: [Help](https://attio.com/help) > [Reference](https://attio.com/help/reference) > [Apps](https://attio.com/help/reference/apps) > [Data and enrichment apps](https://attio.com/help/reference/apps/data-and-enrichment-apps) Run lemlist campaigns from Attio. [lemlist](https://www.lemlist.com/) is a sales engagement platform for personalized cold email, follow-ups, and multi-channel campaigns. Connecting lemlist to Attio lets you add people to campaigns from their record, enrich records with data from lemlist, and start workflows when something happens in a campaign. For example, when a deal moves to Closed Lost, a workflow can pause that person's leads in every campaign so they stop receiving outreach. ## Connect lemlist to Attio lemlist uses a single API key for the whole workspace. Every record action and workflow step runs on that one connection, so a member doesn't need a lemlist account of their own to add people to campaigns or build workflows. - In lemlist, click your profile picture in the lower left, then go to **Settings > Integrations**. - Click **Generate a new API key** and copy it. lemlist won't show it again. - In Attio, click your workspace name, then click **Apps and integrations**. - Search for and open the **lemlist** app, then click **Install**. - Under **Workspace connection**, click **Connect** and paste in your API key. The app page also shows **Member connections**, where each member can connect their own lemlist account. That connection is used only by lemlist's MCP tools in the **Custom agent** workflow step. If you aren't giving an agent access to lemlist, you don't need one. ## Set defaults for adding leads Admins can set what happens each time a person is added to a campaign. Open the **lemlist** app from **Apps and integrations**, then find **Add to campaign defaults**. - **Find email:** Find a verified email address when adding a lead. - **Find phone:** Find a phone number when adding a lead. - **Enable social enrichment:** Run social enrichment when adding a lead. - **Verify email:** Verify the existing email address. - **Deduplicate:** Skip adding the lead if the email already exists in another campaign. These defaults apply to the record actions and to the **Add to campaign** workflow step. The step has the same five options, and anything you set there overrides the default for that workflow. > **Note:** Each of these options can use lemlist credits. Check your lemlist plan before turning them on for a whole workspace. ## Add people to campaigns from a record You can add people to a lemlist campaign without building a workflow. - Open a **People** record, then click **Add to campaign** in the record menu. - Select a campaign. - Review the lead preview, which shows what Attio will send to lemlist. - Click **Add to campaign**. To add several people at once, select them in any people view, click **Add to campaign**, and choose a campaign. Attio processes them in batches and reports how many were added, how many were skipped because they had no email address, and how many were already in the campaign. Attio sends the person's name, email addresses, job title, phone number, LinkedIn URL, and company details, plus every custom attribute on the record as a lemlist custom variable prefixed with `attio_`. A custom attribute named Industry arrives in lemlist as `attio_industry`. The lead is owned by the lemlist team member whose lemlist email matches the Attio email of the person running the action. If no lemlist user matches, the lead is assigned to your lemlist workspace admin and Attio tells you why. > **Note:** A person record needs an email address before you can add them to a campaign. To open someone's lemlist profile from Attio, click **Open in lemlist** in the record menu. Attio looks the person up in lemlist by email and shows their lemlist details along with a link to their profile. ## Use lemlist steps in a workflow lemlist adds one trigger and eight steps to the workflow builder. ### Triggers #### New activity New activity starts a workflow when a lemlist activity event happens. Inputs: - **Event type:** Select the lemlist activity that starts the workflow. Options cover email events, LinkedIn events, call outcomes, and campaign lifecycle events, such as **Lead replied to an email** or **Lead completed all campaign steps**. - **Campaign:** Limit the trigger to a single campaign. Leave this empty to trigger on activity in any campaign. Outputs: - The activity's data. What lemlist returns depends on the event type you select. ### Steps #### Add to campaign Add to campaign adds a person as a lead in a lemlist campaign. Inputs: - **Campaign:** The lemlist campaign to add the lead to. - **Email:** The lead's email address. - **First name**, **Last name**, **Company name**, **Job title**, **LinkedIn URL**, **Phone number**, and **Company domain**: Details to store against the lead. Anything you leave empty is left off. - **Lead owner:** The lemlist team member who owns the lead. Select a team member, or pass a lemlist user ID or email address from an earlier step. - **Find email**, **Find phone**, **Enable social enrichment**, **Verify email**, and **Deduplicate**: Override the workspace defaults for this workflow. These can't be set from a workflow variable. Outputs: - **Lead ID**, **Campaign ID**, and **Email**, which you can use in later steps. > **Note:** Unlike the record action, this step doesn't send your Attio custom attributes to lemlist. Only the inputs you fill in are sent. #### Create task Create task creates a task in lemlist and assigns it to a team member. Inputs: - **Assign to:** The lemlist team member the task belongs to. - **Type:** The task type. **Manual task** is currently the only type lemlist accepts. - **Record:** The lemlist contact or company the task relates to. - **Due date:** When the task is due. - **Priority:** Select **None**, **Low**, **Medium**, or **High**. - **Title** and **Description:** What the task says. Outputs: - **Task ID**, **Type**, **Due date**, **User ID**, and **Contact ID**. #### Find email Find email uses lemlist to find an email address for a person. Inputs: - **LinkedIn URL**, **First name**, **Last name**, and **Company name:** Fill in at least one so lemlist has something to search on. Outcomes: - **Found:** Outputs **Email**. - **Not found:** lemlist couldn't find an email address. This isn't treated as an error, so you can branch your workflow on it. #### Find phone number Find phone number uses lemlist to find a phone number for a person. Inputs: - **Email**, **LinkedIn URL**, **First name**, **Last name**, and **Company name:** Fill in at least one. Outcomes: - **Found:** Outputs **Phone number**. - **Not found:** lemlist couldn't find a phone number. #### Get LinkedIn data Get LinkedIn data uses lemlist to find a LinkedIn profile for a person. Inputs: - **Email**, **Phone number**, **First name**, **Last name**, and **Company name:** Fill in at least one. Outcomes: - **Found:** Outputs **LinkedIn URL**, **First name**, **Last name**, **Location**, **Industry**, **Company name**, **Company domain**, **Occupation**, and **Tagline**. - **Not found:** lemlist couldn't find a profile. #### Verify email Verify email uses lemlist to check whether an email address is valid. Input: - **Email:** The address to check. Outcomes: - **Valid** - **Invalid** #### Get leads by email Get leads by email looks up someone's lemlist leads by their email address. Use it to check which campaigns a person is already in before enrolling them again. Input: - **Email address:** The address to look up. Outcomes: - **Found:** Outputs a list of leads, each with **Lead ID**, **Email**, **First name**, **Last name**, **Campaign ID**, **Campaign name**, **Lead state**, and **Is paused**. - **Not found:** This email has no leads in lemlist. #### Pause lead Pause lead pauses someone's lead so they stop receiving campaign steps. Inputs: - **Email address:** The lead's email address. - **Lead ID:** A specific lemlist lead, usually from an earlier step. Providing this skips the email lookup. - **Campaign:** Pause the lead in one campaign. Leave this empty to pause the lead in every campaign they're in. Outcomes: - **Paused:** Outputs **Paused campaigns**, listing the **Campaign ID** and **Lead ID** for each one. - **Not found:** No matching lead was found. Fill in either **Email address** or **Lead ID**. The step fails if both are empty. ## Related resources Learn more about [building a workflow](https://attio.com/help/reference/automations/workflows/create-a-workflow) and reference all steps available in the [workflows block library](https://attio.com/help/reference/automations/workflows/workflows-block-library). lemlist also has its own guides for [setting up the integration](https://help.lemlist.com/en/articles/15554084-how-to-connect-attio-and-lemlist), [use cases and examples](https://help.lemlist.com/en/articles/15554283-attio-and-lemlist-use-cases-and-automation-examples), and [troubleshooting](https://help.lemlist.com/en/articles/15554284-fix-attio-and-lemlist-integration-not-working), for reference. ## FAQ ### Does lemlist activity sync to Attio automatically? No, lemlist activity reaches Attio through workflows. Use the **New activity** trigger to start a workflow when a lead opens an email, replies, or reaches any other lemlist event, then add steps to record what you need on the relevant record. ### Why was my lead assigned to the wrong owner? Attio matches the lead owner by email address. If nobody in your lemlist team has a lemlist account using the same email address as their Attio account, the lead is assigned to your lemlist workspace admin instead. ### Why did some people get skipped when I added a group to a campaign? Attio skips people who have no email address on their record, and lemlist skips leads that are already in that campaign. The summary that appears when the run finishes tells you how many fell into each case. ### Do the enrichment steps use lemlist credits? Yes. **Find email**, **Find phone number**, **Get LinkedIn data**, and **Verify email** all run against lemlist's enrichment, as do the matching options on **Add to campaign**. Check your lemlist plan for how those credits work.