ToolsLeads
mailmoo_leads_remove_from_campaign
Remove leads from a campaign
Removes leads from one campaign: their sequence there stops and their rows and column values in that campaign are deleted. The people stay in the workspace, in their other campaigns and in the inbox. Select all of the campaign's leads, a filtered part, or specific lead ids, up to 5,000. Without confirm it changes nothing and returns how many would be removed: show that and ask, then call again with confirm: true. To stop outreach but keep them, use leads_bulk_update with pause. To delete the people themselves from the workspace, use person_delete.
Effect: Write. See Effects.
Permissions: Read campaigns, Write campaigns.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign | string | Yes | The campaign, by name or id. |
leadIds | array of string | No | Exactly these leads. Overrides the filters. |
query | string | No | Search box text: name, email, company, or profile URL. |
company | string | No | Only leads whose company name contains this text. |
companies | array of string | No | Leads at any of these companies, by name (contains). Each name counts toward the filter limit. Use instead of company. |
columnEquals | array of object | No | Only leads whose campaign column holds this value, e.g. [{ column: 'Interested', value: 'true' }]. Needs campaign. Column names from campaign_get_context. |
jobTitle | string | No | Only leads whose job title contains this text. |
industry | string | No | Only leads whose industry contains this text. |
sequenceStatus | IN_PROGRESS, COMPLETED, PAUSED, FAILED | No | Only leads whose sequence is in this state: IN_PROGRESS, COMPLETED, PAUSED, or FAILED. |
pipelineStage | string | No | Only leads in this pipeline stage: a category such as IN_CONVERSATION, or a stage name. |
excludePipelineStage | string | No | Leave out leads in this pipeline stage, e.g. MEETING_BOOKED to skip anyone who already booked. |
connectionAccepted | boolean | No | true: only leads who accepted the connection request. false: only leads who did not. For pending, not accepted or never requested, use connection. |
connection | accepted, pending, declined, never_requested | No | Where the connection request stands with the lead's sender. accepted: connected. pending: sent, still waiting. declined: sent, and the wait for acceptance ran out without a connection (ignored requests count too). never_requested: no request sent yet. Use instead of connectionAccepted, not with it. |
confirm | boolean | No | Leave out first: the call then changes nothing and returns what would happen. Show that to the user, and call again with confirm: true once they agree. |

