lemlist

Deletes a lemlist company. Refuses by default when contacts are still attached — pass `force=true` to detach them (the `companyId` field is unset on each contact) before deleting the company. **No CRM-side propagation:** only the lemlist record is removed. Designed for the contact-to-company remapping workflow: after reassigning the contacts of a duplicate company to the canonical one (via `POST /contacts/{idOrEmail}`), call this endpoint to drop the now-empty duplicate.

Disconnect Email Account

Soft-deletes a draft by setting its deletedAt timestamp.

Removes one or more labels from one conversation.

Delete or Unsubscribe Lead

Erases the values of custom variables on a lead.

Unsubscribe Lead from Campaign

Delete Schedule

Delete Sequence Step

Delete Unsubscribe Email

Removes the unsubscribed (do-not-contact) flag from a contact.

Removes a variable from the unsubscribe list. Variables with a protected source (LEAD or ABUSE) cannot be re-subscribed.

Delete Webhook

Export leads from a campaign with filtering options. Returns leads in CSV or JSON format based on their state (e.g., contacted, interested, replied, etc.).

Get Campaign

Check the status of an asynchronous campaign export.

Retrieve reports for one or multiple campaigns. Returns aggregated statistics and export status for the specified campaigns.

Retrieve detailed statistics for a specific campaign, with filtering options by date, user, A/B testing, and communication channels.

Retrieves validation statutes for a campaign, including errors that block launching and warnings about daily limits, DNS issues, etc. Uses the same validation engine as the lemlist UI.

Get Many Campaigns

Start an asynchronous export of all campaign statistics. The final export result is a CSV file.

Get Company Notes

Get Many Companies

Exports contacts or companies from a CRM list as a CSV file. The response is streamed as `text/csv` with a `Content-Disposition: attachment` header. The exported columns depend on the `entity` type: - **contact**: firstName, lastName, email, linkedinUrl, companyName, jobTitle, phone, status, owner, campaigns, contactLists, and more. - **company**: name, domain, linkedinUrl, industry, website, status, size, owner, numberOfContacts, companyLists, and more. Custom fields are included as additional columns.

Get Contact

Retrieves all static and dynamic contact lists for the team. Optionally filter by name.

Retrieves contacts by IDs/emails, or searches/lists contacts by name, email, contact list, campaign membership, or company link. When using `idsOrEmails`, returns an array of matching contacts directly. When using `search`, `email`, `listId`, `notInAnyCampaign`, any of the `company*` filters, or no filter at all, returns a paginated response with `data`, `total`, `limit`, and `offset` fields. You can combine filters together to narrow results (e.g. `listId` with `search`, or `notInAnyCampaign` with `companyId`). Calling the endpoint without any filter returns all contacts of the team, paginated. The `company*` filters (`companyId`, `companyDomain`, `companyLinkedinUrl`, `companySalesnavUrl`) are mutually exclusive — use only one at a time. `companyDomain` / `companyLinkedinUrl` / `companySalesnavUrl` are resolved to a `companyId` through the Companies collection; if no matching company exists, the endpoint returns an empty list with `total: 0` (not an error), which keeps automation flows simple.

Get CRM Filters

Get Team CRM Users

Get Enrichment Result

List Fields

Get Contact Messages

Retrieves a single draft with its full content, including attachments.

Get info of a specific label.

Get Many Inboxes

List all labels available to your team.

Lists all non-deleted drafts for a specific contact.

Get Campaign Leads

Get Lead by Email

Retrieve a lead using either their email address or lead ID

Get Database Filters

Get Campaign Schedules

Get Many Schedules

Get Schedule

Get Campaign Sequences

Retrieve tasks with optional filtering and pagination. Tasks marked as `done` are excluded from results.

Get Team Credits

Get Team Senders

Get Team

Exports all contacts with their subscription status to a CSV file.

Exports all unsubscribed variables to a CSV file.

Export Unsubscribes

Checks whether a contact is unsubscribed (do-not-contact).

Get Many Unsubscribes

Get Unsubscribe by Email

Retrieves a specific unsubscribed variable by its value.

Retrieves a paginated list of all unsubscribed variables (emails, domains, LinkedIn URLs, phone numbers).

Get User Channels

Get User

Get Signal Agent signals

Get Many Webhooks

Update Campaign

Partially updates an existing draft. Only the provided fields will be updated.

Update Lead in a Campaign

Update values of custom variables for a lead.

Update Schedule

Update Sequence Step

Update task details such as assignment, due date, title, message, priority, or completion status.

Create Campaign

Duplicate Campaign

Retrieve detailed statistics for multiple campaigns in a single request, with filtering options by date, user, A/B testing, and communication channels. Processes up to 100 campaigns per request.

Pause Campaign

Start Campaign

Create Company Note

Creates a new company or updates an existing one (upsert). If a company with the same domain, LinkedIn URL, or Sales Navigator URL already exists, it will be updated with the provided non-empty fields. Null or empty values are ignored during updates to preserve existing data. You can target an existing company directly by providing `companyId`, bypassing domain/LinkedIn matching — in that case `name` and `domain` become optional.

Creates a new static contact list. After creating the list, use `POST /contacts/lists/{listId}/entities` to add contacts to it.

Adds existing CRM contacts to a static contact list, or removes them when `?action=remove` is set. - **Add** (default): send a `POST` with a `contactIds` body. Contacts already in the list are silently skipped (no duplicates) and reported in `alreadyInList`. - **Remove**: send a `POST` with `?action=remove` and a `contactIds` body. Contacts that are not in the list are silently skipped; `removedCount` reflects the associations actually removed. This only affects list membership, the contacts are not deleted from your CRM. The list must be a **static** contact list (`clt_xxx`). Dynamic lists (auto-populated by filter rules) and company lists are rejected. **Removal uses `POST ?action=remove` on purpose:** a `DELETE` request body is dropped by our stack, so `DELETE` on this path is **not supported** and returns `405 Method Not Allowed`.

Creates a new contact or updates an existing one (upsert). If a contact with the same email, LinkedIn URL, or Sales Navigator URL already exists, it will be updated with the provided non-empty fields. Null or empty values are ignored during updates to preserve existing data. You can target an existing contact directly by providing `contactId`, bypassing email/LinkedIn matching. You can optionally link the contact to a company by providing `companyId`, `companyDomain`, or `companyLinkedinUrl`.

Connect Email Account

Test Email Account

Send a batch of enrichment requests for multiple entities. Maximum 500 enrichment requests per call.

Enrich Data

Enrich Lead

Attaches one or more labels to one or more conversations.

Creates a new draft for a specific contact. The source is automatically set to "api".

Creates a new label available to the team.

Send Email

Send LinkedIn Message

Send WhatsApp Message

Add custom variables to a lead and sets values for that specific lead.

Create Lead in Campaign

Import Leads from CRM

Use this endpoint to launch a lead that is waiting for review, without having to enable campaign-wide auto-review. You're auto launching this specific lead, while still enforcing every other launch guard: the campaign must have no step errors, any AI variables required by the campaign must be valid for the lead, and a sender must be available. No need to enable autolaunch in the campaign. This endpoint requires an `emailPro` plan or higher.

Mark Lead as Interested in Campaign

Mark a lead as interested across all campaigns

Mark Lead as Not Interested in Campaign

Mark a lead as not interested across all campaigns

Pause Lead

Resume Paused Lead

Upload Audio for Voice Message Step

Search the lemlist Companies database using structured filters with pagination support. Returns comprehensive company data including technologies used, location, employee count, and other business intelligence.

Associate Schedule with Campaign

Create Schedule

Add Step to Sequence

Create a manual task (opportunity) associated with a contact/company or lead.

Ignore Tasks

Add Unsubscribe Email or Domain

Unsubscribes up to 10,000 variables in a single request.

Marks a contact as unsubscribed (do-not-contact).

Unsubscribes a single variable. This operation is idempotent — if the variable is already unsubscribed, the existing record is returned.

Add Webhook

Set an email address for a given export. When the export is done, an email with the download URL will be sent to the address provided.

This endpoint allows you to query our People database. To do so, you may use the following parameters: filters (required), page (optional), size (optional), and excludes (optional). Each filter should have the following properties: filterId (filter identifier), in (list of the values you want to include), and out (list of the values you want to exclude). To know which filters you are able to use, refer to the GET Filters section. The `department` filter accepts the following values: `Sales`, `Customer service`, `Engineering`, `Marketing`, `Operations`, `Human Resources`, `Finance / Legal / Admin`, `Other`.