lemlist
App · Email Marketing · 5 actions
Automate lemlist cold outreach: list campaigns, add and remove leads, look leads up, and pull engagement activities with an API key.
Actions
| Action | What it does |
|---|---|
| Add lead to campaign | Add a lead to a lemlist campaign, creating the lead if it does not exist yet. |
| Delete lead from campaign | Delete a lead from a campaign. |
| Get activities | Retrieve recent campaign activities such as emails sent, opened, clicked, replied, or bounced. |
| Get lead | Look up a single lead by email address, returning its profile and current campaign status. |
| List campaigns | List the campaigns in your lemlist account. |
Add lead to campaign
Add a lead to a lemlist campaign, creating the lead if it does not exist yet. The lead enters the campaign's sequence and starts receiving its steps.
Inputs
- Campaign ID
campaign_idtextRequired - Id of the campaign to add the lead to, as returned by List campaigns (e.g. cam_aaWL92T22Sei3Bz6v).
- Email
emailtextRequired - The lead's email address.
- First name
first_nametext - The lead's first name.
- Last name
last_nametext - The lead's last name.
- Company name
company_nametext - The lead's company name.
- Phone
phonetext - The lead's phone number.
- LinkedIn URL
linkedin_urltext - URL of the lead's LinkedIn profile.
- Company domain
company_domaintext - Domain of the lead's company (e.g. acme.com).
- Icebreaker
icebreakertext - Personalized opening line, usable as the {{icebreaker}} variable in the campaign's emails.
- Skip if already in another campaign
deduplicatetrue/false - When true, the lead is not added if the same email is already present in another campaign.
- Verify email first
verify_emailtrue/false - When true, lemlist verifies the email address before adding the lead. This uses lemlist credits.
Outputs
_idtext- lemlist lead id
campaignIdtext- Id of the campaign the lead belongs to
campaignNametext- Name of the campaign the lead was added to
companyNametext- The lead's company
emailtext- The lead's email address
firstNametext- The lead's first name
isPausedtrue/false- Whether the lead is currently paused
lastNametext- The lead's last name
Example output
{
"_id": "lea_aaNfSAHJoa4gj86Px",
"campaignId": "cam_aaWL92T22Sei3Bz6v",
"campaignName": "Q3 Outreach",
"companyName": "Acme",
"email": "jane@acme.com",
"firstName": "Jane",
"isPaused": false,
"lastName": "Doe"
}Delete lead from campaign
Delete a lead from a campaign. This removes the lead and its statistics from that campaign and cannot be undone.
Inputs
- Campaign ID
campaign_idtextRequired - Id of the campaign to remove the lead from.
- Email
emailtextRequired - Email address of the lead to delete.
Outputs
_idtext- Deleted lead id
deletedtrue/false- Whether the lead was deleted
emailtext- Email of the deleted lead
Example output
{
"_id": "lea_aaNfSAHJoa4gj86Px",
"deleted": true,
"email": "jane@acme.com"
}Get activities
Retrieve recent campaign activities such as emails sent, opened, clicked, replied, or bounced. Useful for reporting and for triggering follow-up automations.
Inputs
- Activity type
typetext - Optional. Only return activities of this type, e.g. emailsSent, emailsOpened, emailsClicked, emailsReplied, or emailsBounced.
- Campaign ID
campaign_idtext - Optional. Only return activities for this campaign.
- Limit
limitnumber - How many activities to return (1-100).From 1 to 100. Default:
100. - Offset
offsetnumber - How many activities to skip, for pagination.At least 0. Default:
0. - First occurrence only
is_firsttrue/false - When true, only the first time each activity happened for a lead is returned.
Outputs
activitieslist- Recent activities
Example output
{
"activities": [
{
"_id": "act_aaXiFy3Y7BNSuYwDr",
"campaignId": "cam_aaWL92T22Sei3Bz6v",
"campaignName": "Q3 Outreach",
"createdAt": "2026-07-20T14:56:39.172Z",
"leadEmail": "jane@acme.com",
"type": "emailsOpened"
}
]
}Get lead
Look up a single lead by email address, returning its profile and current campaign status.
Inputs
- Email
emailtextRequired - Email address of the lead to look up.
- Campaign ID
campaign_idtext - Optional. Restrict the lookup to this campaign id.
Outputs
_idtext- lemlist lead id
campaignIdtext- Id of the campaign the lead belongs to
companyNametext- The lead's company
emailtext- The lead's email address
firstNametext- The lead's first name
isPausedtrue/false- Whether the lead is currently paused
lastNametext- The lead's last name
Example output
{
"_id": "lea_aaNfSAHJoa4gj86Px",
"campaignId": "cam_aaWL92T22Sei3Bz6v",
"companyName": "Acme",
"email": "jane@acme.com",
"firstName": "Jane",
"isPaused": false,
"lastName": "Doe"
}List campaigns
List the campaigns in your lemlist account. Returns each campaign's id, which the lead actions use as 'campaign_id'.
Inputs
- Limit
limitnumber - How many campaigns to return (1-100).From 1 to 100. Default:
100. - Offset
offsetnumber - How many campaigns to skip, for pagination.At least 0. Default:
0.
Outputs
campaignslist- Campaigns in the account
Example output
{
"campaigns": [
{
"_id": "cam_aaWL92T22Sei3Bz6v",
"id": "cam_aaWL92T22Sei3Bz6v",
"labels": [
"outbound"
],
"name": "Q3 Outreach"
}
]
}