> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lemlist

> lemlist is a prospecting tool that automates multichannel outreach, enabling users to find leads with valid contact information and reach them across email, LinkedIn, or calls with personalized messages.

![Lemlist logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/lemlist.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=11d2946ab5fc7ca17e2fb3738e741f5d)

* **Category:** marketing automation
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 65
* **Triggers:** 0
* **Slug:** `LEMLIST`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Contacts To List
>
> **Slug:** `LEMLIST_ADD_CONTACTS_TO_LIST`
>
> Add existing Lemlist contacts to a static contact list.
>
> #### Input Parameters
>
> **listId** `string` *required*
>
> Static contact list ID in clt\_\* format.
>
> **contactIds** `array` *required*
>
> One to 1,000 existing contact IDs in ctc\_\* format to add.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Company Note
>
> **Slug:** `LEMLIST_CREATE_COMPANY_NOTE`
>
> Tool to create a note attached to a specific company. Use when you need to add annotations or notes to a company record for tracking purposes.
>
> #### Input Parameters
>
> **note** `string` *required*
>
> The note content to be created for the company.
>
> **companyId** `string` *required*
>
> The unique identifier of the company to attach the note to.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Schedule
>
> **Slug:** `LEMLIST_DELETE_DELETE_SCHEDULE`
>
> Tool to delete a specific schedule by scheduleId. Use when you need to remove a schedule permanently after confirming its ID.
>
> #### Input Parameters
>
> **scheduleId** `string` *required*
>
> The unique ID of the schedule to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Unsubscribed Email
>
> **Slug:** `LEMLIST_DELETE_DELETE_UNSUBSCRIBE_EMAIL`
>
> Tool to delete an email from the unsubscribed list. Use when restoring a subscriber who has opted back in and you need to remove them from the suppressed contacts.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to remove from the unsubscribed list
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unsubscribe Lead From Campaign
>
> **Slug:** `LEMLIST_DELETE_UNSUBSCRIBE_LEAD_FROM_CAMPAIGN`
>
> Tool to unsubscribe a lead from a campaign. Use when you need to stop further outreach by removing a lead from the specified campaign.
>
> #### Input Parameters
>
> **leadId** `string` *required*
>
> The unique ID of the lead to unsubscribe
>
> **campaignId** `string` *required*
>
> The unique ID of the campaign from which the lead will be unsubscribed
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Webhooks
>
> **Slug:** `LEMLIST_GET_ALL_WEBHOOKS`
>
> Retrieve the team's configured webhooks for synchronization or audit. An empty or non-JSON response is returned as an empty webhook list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Campaign By ID
>
> **Slug:** `LEMLIST_GET_CAMPAIGN_BY_ID`
>
> Tool to retrieve a specific campaign by campaignId. Use when you need detailed campaign information by ID.
>
> #### Input Parameters
>
> **campaignId** `string` *required*
>
> Unique identifier of the campaign to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start Campaign Export
>
> **Slug:** `LEMLIST_GET_CAMPAIGN_EXPORT_START`
>
> Tool to start an asynchronous export of all campaign statistics (CSV). Use when you need to initiate a CSV export for a given campaign and track its progress.
>
> #### Input Parameters
>
> **campaignId** `string` *required*
>
> Unique identifier of the campaign to export.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Campaign Export Status
>
> **Slug:** `LEMLIST_GET_CAMPAIGN_EXPORT_STATUS`
>
> Tool to check the status of an asynchronous campaign export. Use after starting an export to poll until done or error.
>
> #### Input Parameters
>
> **exportId** `string` *required*
>
> The ID of the export job returned from the start export endpoint.
>
> **campaignId** `string` *required*
>
> The ID of the campaign whose export is being checked.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Campaign Schedules
>
> **Slug:** `LEMLIST_GET_CAMPAIGN_SCHEDULES`
>
> Retrieve all sending schedules associated with a campaign.
>
> #### Input Parameters
>
> **campaignId** `string` *required*
>
> Unique identifier of the campaign whose schedules to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Campaign Sequences
>
> **Slug:** `LEMLIST_GET_CAMPAIGN_SEQUENCES`
>
> Retrieve a campaign's sequences as a mapping keyed by sequence ID, including steps and branching conditions.
>
> #### Input Parameters
>
> **campaignId** `string` *required*
>
> Unique identifier of the campaign to fetch sequences for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Campaign Stats
>
> **Slug:** `LEMLIST_GET_CAMPAIGN_STATS`
>
> Tool to retrieve performance statistics for a specific campaign within a date range. Use when you need campaign analytics including lead engagement, message delivery, and step-by-step performance metrics.
>
> #### Input Parameters
>
> **endDate** `string` *required*
>
> End date for the statistics period in ISO 8601 format (e.g., 2026-02-14T23:59:59.999Z).
>
> **channels** `array`
>
> Filter by communication channels. Valid values include 'email', 'linkedin'.
>
> **sendUser** `string`
>
> Filter statistics by specific user. Format: sendUserId|sendUserEmail
>
> **startDate** `string` *required*
>
> Start date for the statistics period in ISO 8601 format (e.g., 2025-01-01T00:00:00.000Z).
>
> **ABSelected** `string`
>
> Filter by A/B test variant. Valid values: 'A' or 'B'.
>
> **campaignId** `string` *required*
>
> Unique identifier of the campaign to retrieve statistics for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Companies Schema
>
> **Slug:** `LEMLIST_GET_COMPANIES_SCHEMA`
>
> Tool to retrieve the schema definition for companies in the people database. Use when you need to understand the structure, fields, and data types available for company records.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact
>
> **Slug:** `LEMLIST_GET_CONTACT`
>
> Retrieve one Lemlist contact by contact ID or email address.
>
> #### Input Parameters
>
> **idOrEmail** `string` *required*
>
> Lemlist contact ID (ctc\_\*) or email address. CRM record IDs are not accepted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact Messages
>
> **Slug:** `LEMLIST_GET_CONTACT_MESSAGES`
>
> Retrieve a paginated conversation history for a contact by ID. The request can also mark the conversation as read when a user ID is supplied.
>
> #### Input Parameters
>
> **skip** `integer`
>
> Number of items to skip for pagination (default: 0)
>
> **limit** `integer`
>
> Maximum number of messages to retrieve
>
> **userId** `string`
>
> Identifier of the user viewing the conversation. Required if markAsRead is provided.
>
> **contactId** `string` *required*
>
> The unique identifier of the contact (format: ctc\_\*)
>
> **markAsRead** `boolean`
>
> When true, marks the conversation as read (default: false). Requires userId to be provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Database Filters
>
> **Slug:** `LEMLIST_GET_DATABASE_FILTERS`
>
> Tool to retrieve available filters for searching the people and companies database. Use when you need to discover what search criteria are available before querying the database.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Export Campaign Leads
>
> **Slug:** `LEMLIST_GET_EXPORT_CAMPAIGN_LEADS`
>
> Tool to export campaign leads with state filtering and choose between JSON or CSV output. Use when you need to download leads and their statuses for reporting or analysis.
>
> #### Input Parameters
>
> **state** `string` *required*
>
> Filter to export only the specified leads' last state. Specify one of the global states: imported, scanned, skipped, reviewed, contacted, hooked, attracted, warmed, interested, notInterested, emailsBounced, emailsUnsubscribed, meetingBooked, paused, failed; or detailed states: emailsSent, emailsOpened, emailsClicked, emailsReplied, emailsInterested, emailsNotInterested, emailsFailed, opportunitiesDone, aircallDone, aircallInterested, aircallNotInterested, apiDone, apiInterested, apiNotInterested, linkedinVisitDone, linkedinVisitFailed, linkedinInviteDone, linkedinInviteAccepted, linkedinInviteFailed, linkedinSent, linkedinOpened, linkedinReplied, linkedinInterested, linkedinNotInterested, linkedinSendFailed, manualInterested, manualNotInterested. Use 'all' to export all leads regardless of state.
>
> **format** `string ("json" | "csv")`
>
> Output format for the export. Choose 'json' or 'csv'.
>
> **campaignId** `string` *required*
>
> The ID of the campaign to export leads from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Export Unsubscribes
>
> **Slug:** `LEMLIST_GET_EXPORT_UNSUBSCRIBES`
>
> Tool to download a CSV file containing all unsubscribed email addresses. Use when you need to export the full unsubscribes list for analysis or archival.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Unsubscribed Email
>
> **Slug:** `LEMLIST_GET_GET_UNSUBSCRIBE_EMAIL`
>
> Tool to retrieve a single unsubscribed email record. Use when you need to verify if a specific email has opted out of campaigns before re-subscribing them.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address of the unsubscribed user to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Label
>
> **Slug:** `LEMLIST_GET_LABEL`
>
> Tool to retrieve information about a specific label by its ID. Use when you need details about an inbox label.
>
> #### Input Parameters
>
> **labelId** `string` *required*
>
> Unique identifier of the label to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Lead By ID
>
> **Slug:** `LEMLIST_GET_LEAD_BY_ID`
>
> Retrieve one Lemlist lead using its known lead identifier.
>
> #### Input Parameters
>
> **leadId** `string` *required*
>
> Unique identifier of the lead to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Lemwarm Settings
>
> **Slug:** `LEMLIST_GET_LEMWARM_SETTINGS`
>
> Retrieve Lemwarm configuration and deliverability data for a mailbox.
>
> #### Input Parameters
>
> **userMailboxId** `string` *required*
>
> User mailbox ID from the Get User action, in usm\_\* format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Campaigns
>
> **Slug:** `LEMLIST_GET_LIST_CAMPAIGNS`
>
> Tool to retrieve a list of campaigns for the team. Use when you need to discover campaign IDs, names, or statuses before performing operations like auditing or pausing campaigns.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (alternative to offset).
>
> **limit** `integer`
>
> Maximum number of campaigns to retrieve. Default: 100, Max: 100.
>
> **offset** `integer`
>
> Pagination offset - number of campaigns to skip.
>
> **sortBy** `string`
>
> Field to sort by. Currently only supports 'createdAt'.
>
> **status** `string ("running" | "draft" | "archived" | "ended" | "paused" | "errors")`
>
> Filter campaigns by status.
>
> **sortOrder** `string ("asc" | "desc")`
>
> Sort order: ascending or descending.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tasks
>
> **Slug:** `LEMLIST_GET_LIST_TASKS`
>
> Retrieve a page of pending tasks assigned to team members, with optional filters such as campaign or assignee. Completed tasks are automatically excluded from results.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number (0-indexed). Default: 0.
>
> **filters** `string`
>
> JSON array of filter objects as a string. Available filters: fullName, email, phone, linkedin, campaignId, campaignState, type, assignedTo, dueDate. Must be valid JSON array format (e.g., '\[]' or '\[\{"campaignId":"abc123"}]'). Empty array returns all tasks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Team Senders
>
> **Slug:** `LEMLIST_GET_LIST_TEAM_SENDERS`
>
> Tool to retrieve all team members and their associated campaigns. Use when you need to discover which team members are managing which campaigns or to understand campaign distribution across the team.
>
> #### Input Parameters
>
> **state** `string ("running" | "paused" | "draft" | "ended" | "archived" | "errors")`
>
> Valid campaign states for filtering.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Watchlist Signals
>
> **Slug:** `LEMLIST_GET_LIST_WATCHLIST_SIGNALS`
>
> Tool to retrieve paginated watchlist signals with filtering and sorting. Use when you need to fetch signals from watchlists based on type, status, date range, or specific watchlist ID.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (cannot be used with offset).
>
> **type** `string`
>
> Filter by signal type(s) such as 'jobChange', 'companyIsHiring', 'companyRaisedFunds', 'newHire', 'companyEmployeeVisitedMyWebsite', 'linkedinProfile', 'linkedinTopic'.
>
> **limit** `integer`
>
> Number of signals to retrieve. Maximum value: 100.
>
> **offset** `integer`
>
> Number of records to skip (cannot be used with page).
>
> **sortBy** `string ("receivedAt" | "createdAt")`
>
> Fields available for sorting watchlist signals.
>
> **status** `string`
>
> Filter by signal status(es) like 'new', 'old', 'handled', or 'ignored'.
>
> **sortOrder** `string ("asc" | "desc")`
>
> Sort order direction.
>
> **watchListId** `string`
>
> Filter signals by specific watchlist ID.
>
> **receivedAtTo** `string`
>
> Filter signals received on or before this date (ISO date-time format).
>
> **receivedAtFrom** `string`
>
> Filter signals received on or after this date (ISO date-time format).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get People Schema
>
> **Slug:** `LEMLIST_GET_PEOPLE_SCHEMA`
>
> Tool to retrieve the schema definition for people in the people database. Use when you need to understand available fields and their structure before querying or importing people data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Activities
>
> **Slug:** `LEMLIST_GET_RETRIEVE_ACTIVITIES`
>
> Tool to fetch recent campaign activities. Use after authentication to retrieve activities filtered by campaignId, type, or limit.
>
> #### Input Parameters
>
> **type** `string`
>
> Filter activities by type, e.g., 'paused', 'linkedinInviteAccepted', 'emailSent'.
>
> **limit** `integer`
>
> Maximum number of activities to retrieve. Default: 100, Max: 100.
>
> **leadId** `string`
>
> Filter activities by lead ID.
>
> **offset** `integer`
>
> Number of records to skip for pagination.
>
> **isFirst** `boolean`
>
> Filter for first activity only.
>
> **contactId** `string`
>
> Filter activities by contact ID.
>
> **campaignId** `string`
>
> Filter activities by specific campaign ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Lead By Email
>
> **Slug:** `LEMLIST_GET_RETRIEVE_LEAD_BY_EMAIL`
>
> Retrieve a lead by email address, returning selected lead and campaign details.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address of the lead to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Unsubscribes
>
> **Slug:** `LEMLIST_GET_RETRIEVE_UNSUBSCRIBES`
>
> Retrieve unsubscribe records across campaigns, with offset and limit pagination for syncing or auditing unsubscribed contacts.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of unsubscribes to retrieve per request. Default: 100, Max: 100.
>
> **offset** `integer`
>
> Number of records to skip for pagination.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team Credits
>
> **Slug:** `LEMLIST_GET_TEAM_CREDITS`
>
> Retrieve the team's remaining credits and their breakdown. The credits endpoint returns an error for unpaid accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team Info
>
> **Slug:** `LEMLIST_GET_TEAM_INFO`
>
> Retrieve information about your team, including member IDs, webhooks, and enabled features. Check the returned team identifier against the intended workspace before write operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User
>
> **Slug:** `LEMLIST_GET_USER`
>
> Retrieve a user by ID, including available LinkedIn settings and connected mailbox details.
>
> #### Input Parameters
>
> **userId** `string` *required*
>
> Unique identifier of the user to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Info
>
> **Slug:** `LEMLIST_GET_USER_INFO`
>
> Retrieve available profile details for the authenticated user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Launch Lead
>
> **Slug:** `LEMLIST_LAUNCH_LEAD`
>
> Launch a lead that is waiting for review in its Lemlist campaign.
>
> #### Input Parameters
>
> **leadId** `string` *required*
>
> Lemlist lead ID to launch, in lea\_\* format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Companies
>
> **Slug:** `LEMLIST_LIST_COMPANIES`
>
> Tool to retrieve a paginated list of all companies in your CRM. Use when you need to discover companies, search by name, or fetch company details for further operations.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve.
>
> **limit** `integer`
>
> Quantity of companies to retrieve per page. Default: 100, Max: 100.
>
> **fields** `string`
>
> Specify returned fields as comma-separated list. Omit to get all fields.
>
> **search** `string`
>
> Search by company name (case insensitive).
>
> **sortBy** `string`
>
> Field to sort by. Currently only supports 'createdAt'.
>
> **sortOrder** `string`
>
> Sort direction: 'desc' for descending, other values for ascending.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Company Notes
>
> **Slug:** `LEMLIST_LIST_COMPANY_NOTES`
>
> Retrieve a page of notes associated with a specific company, with optional pagination and sorting. Use to view annotations, comments, or activities logged against a company record.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination.
>
> **limit** `integer`
>
> Number of notes to retrieve; default 100, max 100.
>
> **sortBy** `string`
>
> Sort field; currently supports 'createdAt'.
>
> **companyId** `string` *required*
>
> Unique identifier of the company to retrieve notes for.
>
> **sortOrder** `string`
>
> Sort direction ('asc' or 'desc'); defaults to ascending.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `LEMLIST_LIST_CONTACTS`
>
> Search or filter one paginated contact page; not for batch ID lookup. Use LEMLIST\_GET\_CONTACT to retrieve a known contact by its ID or email.
>
> #### Input Parameters
>
> **email** `string`
>
> Exact contact email to match.
>
> **limit** `integer`
>
> Maximum contacts to return (1-500).
>
> **listId** `string`
>
> Static contact list ID (clt\_\*) whose contacts to return.
>
> **offset** `integer`
>
> Number of matching contacts to skip.
>
> **search** `string`
>
> Text to search across contact name and other searchable fields.
>
> **companyId** `string`
>
> Attached Lemlist company ID in cpn\_\* format. Mutually exclusive with the other company filters.
>
> **companyDomain** `string`
>
> Website domain of the contact's company. Mutually exclusive with the other company filters.
>
> **crmSyncStatus** `string ("synced" | "not_synced" | "error" | "searching" | "not_found" | "invalid_email" | "property_doesnt_exist" | "required_field_missing" | "unique_index_error_contact" | "contact_already_exists_with_name" | "contact_already_exists_with_linkedin_url" | "contact_already_exists_with_email" | "contact_blocked_by_company" | "contact_blocked_by_company_search" | "contact_blocked_by_company_without_name" | "contact_blocked_by_company_without_key" | "contact_blocked_by_company_already_synced")`
>
> CRM synchronization state to match. Requires an active connected CRM.
>
> **notInAnyCampaign** `boolean`
>
> Return only contacts not enrolled in any campaign.
>
> **companyLinkedinUrl** `string`
>
> LinkedIn URL of the contact's company. Mutually exclusive with the other company filters.
>
> **companySalesnavUrl** `string`
>
> LinkedIn Sales Navigator URL of the contact's company. Mutually exclusive with the other company filters.
>
> **withPrimaryCompany** `boolean`
>
> True for contacts linked to a company; false for contacts without one. Mutually exclusive with the company identity filters.
>
> **fieldRejectionReason** `string ("enrichment_duplicate_linkedin_url" | "enrichment_duplicate_linkedin_url_sales_nav" | "enrichment_duplicate_email" | "crm_sync_duplicate_linkedin_url" | "crm_sync_duplicate_linkedin_url_sales_nav" | "crm_sync_invalid_linkedin_url" | "crm_sync_invalid_url" | "crm_sync_invalid_email" | "crm_sync_invalid_phone" | "crm_sync_linkedin_url_not_contact" | "crm_sync_duplicate_contact_blocked" | "crm_sync_duplicate_company_blocked" | "crm_sync_company_data_rejected" | "crm_sync_unsub_state_protected" | "crm_sync_value_oscillating" | "crm_sync_owner_sync_loop" | "crm_sync_unmapped_user" | "crm_sync_value_incompatible" | "crm_sync_unknown_error")`
>
> Reason for a field value Lemlist refused to write.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Inbox Conversations
>
> **Slug:** `LEMLIST_LIST_INBOX_CONVERSATIONS`
>
> List a Lemlist user's inbox conversations one page at a time.
>
> #### Input Parameters
>
> **page** `integer`
>
> One-indexed page number.
>
> **limit** `integer`
>
> Maximum conversations to return on the page.
>
> **userId** `string` *required*
>
> Lemlist user ID whose conversations to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Labels
>
> **Slug:** `LEMLIST_LIST_LABELS`
>
> Tool to list all labels available to your team. Use when you need to retrieve the full list of labels for inbox organization or filtering.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark Lead as Not Interested in Campaign
>
> **Slug:** `LEMLIST_PATCH_MARK_LEAD_AS_NOT_INTERESTED_IN_CAMPAIGN`
>
> Tool to mark a lead as not interested in a specific campaign. Use after confirming campaign and lead IDs to set status to not\_interested.
>
> #### Input Parameters
>
> **campaignId** `string` *required*
>
> The unique identifier of the campaign.
>
> **leadIdOrEmail** `string` *required*
>
> The unique identifier of the lead or the lead's email address.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Campaign
>
> **Slug:** `LEMLIST_PATCH_UPDATE_CAMPAIGN`
>
> Tool to update settings of a campaign. Use after fetching or creating a campaign to adjust name, stop-on behaviors, and other campaign flags.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the campaign.
>
> **campaignId** `string` *required*
>
> Identifier of the campaign to update.
>
> **sequenceSharing** `boolean`
>
> Enable or disable sharing of the sequence.
>
> **autoLeadInterest** `boolean`
>
> Automatically determine lead interest.
>
> **disableTrackOpen** `boolean`
>
> Disable email open tracking.
>
> **disableTrackClick** `boolean`
>
> Disable email click tracking.
>
> **disableTrackReply** `boolean`
>
> Disable reply tracking.
>
> **stopOnLinkClicked** `boolean`
>
> Whether the campaign should stop on any link click.
>
> **opportunityClicked** `boolean`
>
> Mark opportunity when clicked.
>
> **opportunityReplied** `boolean`
>
> Mark opportunity when replied.
>
> **stopOnEmailReplied** `boolean`
>
> Whether the campaign should stop when an email is replied to.
>
> **stopOnMeetingBooked** `boolean`
>
> Whether the campaign should stop when a meeting is booked.
>
> **leadsPausedByInterest** `boolean`
>
> Pause leads when they show interest.
>
> **stopOnLinkClickedFilter** `string`
>
> URL filter for stopping on link click; set to null to unset.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Schedule
>
> **Slug:** `LEMLIST_PATCH_UPDATE_SCHEDULE`
>
> Tool to update an existing schedule with new parameters. Use after retrieving schedule details to adjust days, time window, and limits.
>
> #### Input Parameters
>
> **days** `array`
>
> List of weekdays when sends are allowed. e.g., \['monday','tuesday','wednesday'].
>
> **name** `string`
>
> New name for the schedule.
>
> **enabled** `boolean`
>
> Whether the schedule is active (true) or paused (false).
>
> **sendEnd** `string`
>
> Daily send window end time in HH:mm format. e.g., '17:30'.
>
> **timezone** `string`
>
> IANA timezone for the schedule. e.g., 'Europe/Paris'.
>
> **maxPerDay** `integer`
>
> Maximum number of sends allowed per day.
>
> **sendStart** `string`
>
> Daily send window start time in HH:mm format. e.g., '09:00'.
>
> **scheduleId** `string` *required*
>
> Identifier of the schedule to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Sequence Step
>
> **Slug:** `LEMLIST_PATCH_UPDATE_SEQUENCE_STEP`
>
> Tool to update an existing step in a sequence (edit subject/message/delay/etc.) by sequenceId and stepId. Use after retrieving sequences to modify step content or timing.
>
> #### Input Parameters
>
> **url** `string`
>
> Valid HTTP/HTTPS URL for API call. Only applicable for 'api' type steps.
>
> **type** `string` *required*
>
> Type of the step (required but cannot be changed; must match existing step type). Valid types: 'email', 'linkedinInvite', 'linkedinView', 'linkedinSend', 'manual', 'phone', 'whatsappMessage', 'api', 'conditional', 'sendToAnotherCampaign'.
>
> **delay** `integer`
>
> Delay in hours before step execution. Not applicable for 'sendToAnotherCampaign' type.
>
> **title** `string`
>
> Manual task label. Only applicable for 'manual' type steps.
>
> **method** `string ("GET" | "POST" | "PUT" | "DELETE" | "PATCH")`
>
> HTTP verb for API call. Only applicable for 'api' type steps.
>
> **stepId** `string` *required*
>
> Unique identifier of the step to update.
>
> **message** `string`
>
> Message content. Applicable for 'email', 'manual', 'phone', LinkedIn types, and 'whatsappMessage' steps.
>
> **subject** `string`
>
> Email subject line. Only applicable for 'email' type steps.
>
> **delayType** `string ("within" | "waitUntil")`
>
> Timing logic for conditional steps. Only applicable for 'conditional' type steps.
>
> **altMessage** `string`
>
> Fallback message. Only applicable for 'linkedinSend' type steps.
>
> **campaignId** `string`
>
> Destination campaign ID. Only applicable for 'sendToAnotherCampaign' type steps.
>
> **sequenceId** `string` *required*
>
> Unique identifier of the sequence containing the step.
>
> **conditionKey** `string`
>
> Behavior trigger identifier. Only applicable for 'conditional' type steps.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Step to Sequence
>
> **Slug:** `LEMLIST_POST_ADD_STEP_TO_SEQUENCE`
>
> Tool to add a new step (email, LinkedIn, conditional, etc.) to an existing sequence. Use when building or editing campaign sequences to add outreach steps.
>
> #### Input Parameters
>
> **url** `string`
>
> URL of the API endpoint to call. Required for api steps. Must start with http\:// or https\://
>
> **type** `string ("email" | "manual" | "phone" | "api" | "linkedinVisit" | "linkedinInvite" | "linkedinSend" | "sendToAnotherCampaign" | "conditional" | "whatsappMessage")` *required*
>
> The type of step to create. Must be one of: email, manual, phone, api, linkedinVisit, linkedinInvite, linkedinSend, sendToAnotherCampaign, conditional, whatsappMessage
>
> **delay** `integer`
>
> Delay in seconds before the step executes. Defaults to 0 for the first step, 1 for subsequent steps. For conditional steps with delayType other than 'within', delay is not required
>
> **index** `integer`
>
> Position in the sequence (must be >= -1). If omitted or exceeds the step count, the step is appended to the end
>
> **title** `string`
>
> Title or label for manual steps. Required for manual steps
>
> **method** `string ("GET" | "POST" | "PUT" | "DELETE" | "PATCH")`
>
> HTTP method for API steps. Required for api steps
>
> **message** `string`
>
> Content for email, LinkedIn, manual, phone, or WhatsApp steps. Required for steps that send messages
>
> **subject** `string`
>
> Email subject line. Required for email steps
>
> **delayType** `string ("within" | "waitUntil")`
>
> Delay type for conditional steps. Must be 'within' or 'waitUntil'. For conditional steps with delayType other than 'within', the delay field is not required
>
> **altMessage** `string`
>
> Alternate message for linkedinSend steps
>
> **campaignId** `string`
>
> Target campaign ID for sendToAnotherCampaign steps. Required for sendToAnotherCampaign steps
>
> **sequenceId** `string` *required*
>
> The unique identifier of the sequence to add the step to
>
> **conditionKey** `string ("emailsOpened" | "emailsClicked" | "emailsUnsubscribed" | "meetingBooked" | "linkedinInviteAccepted" | "hasWhatsappAccount")`
>
> Condition type for conditional steps. Must be one of: emailsOpened, emailsClicked, emailsUnsubscribed, meetingBooked, linkedinInviteAccepted, hasWhatsappAccount
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Unsubscribe Email/Domain
>
> **Slug:** `LEMLIST_POST_ADD_UNSUBSCRIBE_EMAIL_DOMAIN`
>
> Tool to add an email or domain to the unsubscribed list. Use when you need to globally block sending to a specific recipient or domain.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address or domain to add to the unsubscribed list. Domain entries must start with '@', e.g. '@example.com'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Variables to Lead
>
> **Slug:** `LEMLIST_POST_ADD_VARIABLES_TO_LEAD`
>
> Tool to add one or more variables to a lead. Use when you need to enrich a lead with custom data after its creation or retrieval.
>
> #### Input Parameters
>
> **leadId** `string` *required*
>
> Unique identifier of the lead to which the variables will be added.
>
> **company** `string` *required*
>
> Namespace for these variables; must match your company name in Lemlist.
>
> **variables** `object` *required*
>
> Mapping of variable names to values. Keys must be unique and not override existing variables.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Associate schedule with campaign
>
> **Slug:** `LEMLIST_POST_ASSOCIATE_SCHEDULE_WITH_CAMPAIGN`
>
> Tool to associate a schedule with a campaign. Use after confirming both campaignId and scheduleId to bind a schedule to its campaign.
>
> #### Input Parameters
>
> **campaignId** `string` *required*
>
> ID of the campaign to which the schedule will be associated
>
> **scheduleId** `string` *required*
>
> ID of the schedule to associate with the campaign
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Campaign
>
> **Slug:** `LEMLIST_POST_CREATE_CAMPAIGN`
>
> Tool to create a new campaign. Use after confirming the team ID. Returns campaign, sequence, and schedule IDs nested under a `data` key (e.g., `result['data']['campaignId']`).
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the campaign to create
>
> **teamId** `string` *required*
>
> The ID of the team under which the campaign will be created
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Label
>
> **Slug:** `LEMLIST_POST_CREATE_LABEL`
>
> Tool to create a new label for inbox conversations. Use when you need to organize inbox messages with custom labels.
>
> #### Input Parameters
>
> **labelName** `string` *required*
>
> Name of the label to create. Must be unique within the team.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Lead In Campaign
>
> **Slug:** `LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN`
>
> Tool to create a lead and add it to a specific campaign. Use when you need to enroll a new lead into an outreach campaign. Supports optional deduplication and enrichment features.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address of the lead (required for lead creation).
>
> **phone** `string`
>
> Contact phone number for the lead.
>
> **jobTitle** `string`
>
> Lead's professional role or job title.
>
> **lastName** `string`
>
> Last name of the lead.
>
> **timezone** `string`
>
> IANA format timezone for the lead (e.g., Europe/Paris, America/New\_York).
>
> **findEmail** `boolean`
>
> If true, attempts to find and verify the lead's email address.
>
> **findPhone** `boolean`
>
> If true, attempts to find the lead's phone number.
>
> **firstName** `string`
>
> First name of the lead.
>
> **campaignId** `string` *required*
>
> Unique identifier of the campaign to add the lead to.
>
> **icebreaker** `string`
>
> Personalized message or icebreaker text for the lead.
>
> **companyName** `string`
>
> Name of the lead's organization.
>
> **deduplicate** `boolean`
>
> If true, checks if email exists in other campaigns and skips insertion if found (prevents duplicate leads).
>
> **linkedinUrl** `string`
>
> URL to the lead's LinkedIn profile.
>
> **verifyEmail** `boolean`
>
> If true, validates the existing email using debounce service.
>
> **contactOwner** `string`
>
> User ID or email of the contact owner responsible for this lead.
>
> **companyDomain** `string`
>
> Domain of the lead's company website.
>
> **linkedinEnrichment** `boolean`
>
> If true, executes LinkedIn enrichment to enhance lead data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Schedule
>
> **Slug:** `LEMLIST_POST_CREATE_SCHEDULE`
>
> Create a team schedule with custom active times or delays for outreach operations. Returns the created schedule and its identifier for association with a campaign.
>
> #### Input Parameters
>
> **end** `string`
>
> Optional end time in HH:mm format. Defaults to '18:00'.
>
> **name** `string`
>
> Optional name for the schedule. Defaults to 'Default schedule'.
>
> **start** `string`
>
> Optional start time in HH:mm format. Defaults to '09:00'.
>
> **timezone** `string`
>
> Optional timezone for the schedule (IANA timezone identifier). Defaults to 'Europe/Paris'.
>
> **weekdays** `array`
>
> Optional list of active weekdays (1=Monday .. 7=Sunday). Defaults to \[1,2,3,4,5].
>
> **secondsToWait** `integer`
>
> Optional delay in seconds between operations. Defaults to 1200 seconds.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Task
>
> **Slug:** `LEMLIST_POST_CREATE_TASK`
>
> Create a task (opportunity) associated with a contact, company, or lead to track outreach follow-ups or action items. Supported task types are email, manual, phone, and LinkedIn.
>
> #### Input Parameters
>
> **type** `string ("email" | "manual" | "phone" | "linkedin")` *required*
>
> Task type - must be one of: email, manual, phone, or linkedin.
>
> **title** `string`
>
> Task title; defaults to empty string if not provided.
>
> **dueDate** `string` *required*
>
> Due date timestamp in ISO 8601 format (e.g., 2026-03-15T10:00:00.000Z).
>
> **message** `string`
>
> Task description/message; defaults to empty string if not provided.
>
> **priority** `string`
>
> Priority level - empty string, 0, 1, or 2; defaults to empty string if not provided.
>
> **recordId** `string` *required*
>
> The ID of the contact, company, or lead associated with the task.
>
> **assignedTo** `string` *required*
>
> The user ID of the team member assigned to the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Ignore Tasks
>
> **Slug:** `LEMLIST_POST_IGNORE_TASKS`
>
> Tool to mark one or more tasks as ignored in Lemlist. Use when you want to dismiss tasks without completing them.
>
> #### Input Parameters
>
> **ids** `array` *required*
>
> Array of task IDs to ignore (e.g., opp\_ouYzdLYGs4RcrHTfm)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark Lead As Interested
>
> **Slug:** `LEMLIST_POST_MARK_LEAD_AS_INTERESTED`
>
> Tool to mark a lead as interested in all campaigns. Use when a lead responds positively and you want to advance or personalize your outreach.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> Email address of the lead to mark as interested.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark Lead As Interested In Campaign
>
> **Slug:** `LEMLIST_POST_MARK_LEAD_AS_INTERESTED_IN_CAMPAIGN`
>
> Tool to mark a lead as interested in a specific campaign. Use after confirming the lead's positive engagement in that campaign.
>
> #### Input Parameters
>
> **leadEmail** `string` *required*
>
> Email address of the lead to mark as interested.
>
> **campaignId** `string` *required*
>
> Unique identifier of the campaign.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark Lead As Not Interested
>
> **Slug:** `LEMLIST_POST_MARK_LEAD_AS_NOT_INTERESTED`
>
> Tool to mark a lead as not interested in all campaigns. Use when a lead explicitly declines outreach and should be paused across campaigns.
>
> #### Input Parameters
>
> **lead\_id\_or\_email** `string` *required*
>
> Email address or lead ID ('lea\_...') to mark as not interested.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Pause a running campaign
>
> **Slug:** `LEMLIST_POST_PAUSE_CAMPAIGN`
>
> Tool to pause a running campaign. Use after confirming you have the correct campaign ID and that the campaign is currently running.
>
> #### Input Parameters
>
> **campaignId** `string` *required*
>
> ID of the campaign to pause
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Pause Lead
>
> **Slug:** `LEMLIST_POST_PAUSE_LEAD`
>
> Tool to pause a lead in all campaigns or a specific campaign. Use when you want to temporarily halt outreach to a lead.
>
> #### Input Parameters
>
> **campaignId** `string`
>
> ID of the campaign to pause the lead in. If omitted, pauses in all campaigns.
>
> **leadIdOrEmail** `string` *required*
>
> Email address of the lead or the lead's Lemlist ID (e.g., lea\_xxx)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Companies Database
>
> **Slug:** `LEMLIST_SEARCH_COMPANIES_DATABASE`
>
> Tool to search the companies database using filters, keywords, and pagination. Use when you need to find companies based on criteria like industry, size, or keywords. Returns a paginated list of companies matching the specified filters.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed). Defaults to 1.
>
> **size** `integer`
>
> Number of results per page. Maximum 100. Defaults to 25.
>
> **search** `string`
>
> Free-text query to search across common company fields like name, domain, and keywords.
>
> **filters** `array`
>
> Array of filter objects to narrow search results by criteria like keywords, industry, or company size.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search People Database
>
> **Slug:** `LEMLIST_SEARCH_PEOPLE_DATABASE`
>
> Tool to search the Lemlist people database using filters, keywords, and pagination. Use when you need to find prospects based on criteria like location, job title, seniority, or company. Supports free-text search and structured filtering.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed). Minimum value is 1.
>
> **size** `integer`
>
> Number of results per page. Must be between 1 and 100.
>
> **search** `string`
>
> Free-text search query across common fields (name, title, company, location). Use for keyword-based filtering.
>
> **filters** `array` *required*
>
> Array of filter objects to narrow search results. Each filter must include filterId, 'in' array, and 'out' array (can be empty).
>
> **excludes** `array`
>
> Array of field names to omit from the response. Use to reduce payload size when certain fields are not needed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Inbox Email
>
> **Slug:** `LEMLIST_SEND_INBOX_EMAIL`
>
> Send a standalone inbox email or reply in an existing Lemlist thread.
>
> #### Input Parameters
>
> **cc** `array`
>
> CC addresses. On a reply, omit to inherit the thread CC or pass an empty list for no CC.
>
> **leadId** `string`
>
> Lead ID whose contact should receive the email. Provide this, contactId, or both.
>
> **message** `string` *required*
>
> Email message as HTML.
>
> **subject** `string`
>
> Subject for a standalone email. Omit when replying in a thread.
>
> **contactId** `string`
>
> Contact ID to email. Provide this, leadId, or both.
>
> **sendUserId** `string` *required*
>
> Lemlist user ID of the sender.
>
> **sendUserEmail** `string` *required*
>
> Email address of the sender.
>
> **replyToActivityId** `string`
>
> Email activity ID in act\_\* format, or 'latest', to reply within a thread.
>
> **sendUserMailboxId** `string` *required*
>
> Connected sender mailbox ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Campaign Lead
>
> **Slug:** `LEMLIST_UPDATE_CAMPAIGN_LEAD`
>
> Update a campaign lead. At least one writable field is required; changing companyName also updates the linked shared company record.
>
> #### Input Parameters
>
> **leadId** `string` *required*
>
> Identifier of the lead to update.
>
> **jobTitle** `string`
>
> New job title for the lead.
>
> **lastName** `string`
>
> New last name for the lead.
>
> **firstName** `string`
>
> New first name for the lead.
>
> **campaignId** `string` *required*
>
> Identifier of the campaign containing the lead.
>
> **companyName** `string`
>
> New name for the company linked to the lead. This updates the shared company record.
>
> **updateStrategy** `string ("overwrite" | "overwriteIgnoreEmpty" | "fillEmptyOnly")`
>
> How existing values are handled: overwrite, ignore empty inputs, or fill only empty fields.
>
> **preferredContactMethod** `string ("email" | "linkedIn")`
>
> Preferred method for contacting the lead: email or LinkedIn.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task
>
> **Slug:** `LEMLIST_UPDATE_TASK`
>
> Tool to update an existing task including assignment, scheduling, and status. Use when modifying task details such as title, priority, due date, or completion status.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the task to update.
>
> **done** `boolean`
>
> Mark task as completed (true) or incomplete (false).
>
> **title** `string`
>
> Updated task title.
>
> **dueDate** `string`
>
> Updated due date in ISO 8601 format.
>
> **message** `string`
>
> Updated task message/description.
>
> **priority** `string ("" | "0" | "1" | "2")`
>
> Priority levels for tasks.
>
> **assignedTo** `string`
>
> The ID of the team member to assign the task to (userId).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upsert Contact
>
> **Slug:** `LEMLIST_UPSERT_CONTACT`
>
> Create a standalone contact or reconcile an existing Lemlist contact.
>
> #### Input Parameters
>
> **crmId** `string`
>
> Closed-beta record ID in the connected CRM to link. Requires the CRM ID remap beta and an admin API key. Pass numeric CRM IDs as strings to preserve identifiers longer than JavaScript's safe integer range.
>
> **email** `string`
>
> Primary email and upsert identifier.
>
> **phone** `string`
>
> Contact phone number.
>
> **skills** `string`
>
> Contact skills.
>
> **source** `string`
>
> Origin of the contact record. Set only on creation and defaults to api.
>
> **picture** `string`
>
> URL of the contact's profile picture.
>
> **summary** `string`
>
> Contact summary or bio.
>
> **tagline** `string`
>
> Contact tagline.
>
> **industry** `string`
>
> Contact industry.
>
> **jobTitle** `string`
>
> Contact job title.
>
> **lastName** `string`
>
> Contact last name.
>
> **location** `string`
>
> Contact location.
>
> **timezone** `string`
>
> Contact timezone.
>
> **companyId** `string`
>
> ID of an existing Lemlist company to link; takes priority over companyDomain and companyLinkedinUrl.
>
> **contactId** `string`
>
> Existing contact ID to update directly.
>
> **firstName** `string`
>
> Contact first name.
>
> **languages** `string`
>
> Contact languages.
>
> **linkedinUrl** `string`
>
> LinkedIn profile URL and alternative upsert identifier.
>
> **contactOwner** `string`
>
> Owner user ID or team-member email.
>
> **customFields** `object`
>
> Additional registered Lemlist CRM fields to write. Explicit standard field names are ignored here; use their dedicated parameters instead.
>
> **companyDomain** `string`
>
> Domain of an existing Lemlist company to link, used when companyId is not provided.
>
> **jobDescription** `string`
>
> Contact job description. When a company is linked, Lemlist saves this as part of the job data.
>
> **updateStrategy** `string ("overwriteIgnoreEmpty" | "overwrite" | "fillEmptyOnly")`
>
> How sent values affect fields already stored on a matching contact.
>
> **additionalEmails** `array`
>
> Additional valid email addresses for the contact.
>
> **peopleDbSeniority** `string`
>
> Seniority of the person from the People Database.
>
> **companyLinkedinUrl** `string`
>
> LinkedIn URL of an existing Lemlist company to link, used when companyId and companyDomain are not provided.
>
> **peopleDbDepartment** `string`
>
> Department of the person from the People Database.
>
> **linkedinUrlSalesNav** `string`
>
> Sales Navigator URL and alternative upsert identifier.
>
> **peopleDbConnectionCount** `string`
>
> LinkedIn connection count from the People Database, represented as a string; 500 usually means 500 or more.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
