ToolsProspecting
mailmoo_prospects_add_to_campaign
Add new prospects to a campaign
Sources people from the professional network matching the audience and adds them to a campaign. THIS SPENDS WORKSPACE CREDITS per person (search + profile enrichment + fit scoring) and cannot be undone. Always call prospects_search first, check the sample looks right, then pass searchId from that response so the same search resumes for more people. query/filters work without searchId but re-run from page 1. Duplicates already in the campaign are skipped and not charged. Start with a small maxLeads (default 100, max 500). When credits are the limit, pass fillToBudget. Enrichment beyond this import path is not available over MCP.
Effect: Write. See Effects.
Permissions: Write campaigns.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaignId | string | No | Existing campaign to add the people to. Omit and pass newCampaignName to create one. |
newCampaignName | string | No | Create a campaign with this name for these people. Ignored when campaignId is given. |
searchId | string | No | searchId from prospects_search. Preferred: resumes that preview for more people instead of starting over. |
query | string | No | Plain description of the audience, or a people-search URL the user pasted (runs as-is). Required when searchId is omitted (or pass filters). |
filters | object | No | Exact filters when not using searchId. Pass appliedFilters from prospects_search. |
maxLeads | number | No | Maximum number of people to source and charge for. Defaults to 100, max 500. |
fillToBudget | boolean | No | Import as many as the remaining credits allow rather than failing when maxLeads costs more than the balance. The response reports limitedByCredits and how many actually came in. |

