mailmoo_leads_search
Search leads
Search leads that already exist in the workspace (CRM), or list/search the leads in one campaign. Omit campaignId for the whole workspace; pass campaignId to stay inside that campaign. This does not find new people and does not enrich them. query is a search box: it matches first name, last name, full name, email, company, phone, or social profile URL, not industry, job title, or sequence status. For those, use the named field filters (firstName, lastName, company, jobTitle, industry, sequenceStatus), which compile to the same advanced filters as the lead table (at most 4 of those at once). pipelineStage and tag are separate and do not count toward that limit. Each page returns identity fields, job title, Oracle score, lead-fit score, sequence status, the assigned sender on leadSequence.sdrProfile, pipeline stage, timestamps, and nextCursor when more remain. Pass nextCursor back as cursor to fetch the next page. The full variables list is omitted unless includeVariables is true, because a lead can have fifty variables, some of them long text. Use this before any tool that needs a leadId.
Effect: Read. See Effects.
Permissions: Read CRM, Read leads.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search box text. Matches first name, last name, full name, email, company, phone, or social profile URL. Does not match industry or job title. |
firstName | string | No | Only leads whose first name contains this text. |
lastName | string | No | Only leads whose last name contains this text. |
company | string | No | Only leads whose company name contains this text. |
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. Accepts a category (MEETING_BOOKED), a friendly name (Meeting booked), or NEW for unstaged leads. |
includeVariables | boolean | No | When true, each lead includes every custom and built-in variable. Default false: identity fields only. |
campaignId | string | No | List or search this campaign's leads. Omit to search the whole workspace. |
tag | string | No | Only leads carrying this tag, by name. Use 'untagged' for leads with no tag. |
cursor | string | No | Cursor from a previous response, to fetch the next page. |

