MailMoo
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

ParameterTypeRequiredDescription
campaignIdstringNoExisting campaign to add the people to. Omit and pass newCampaignName to create one.
newCampaignNamestringNoCreate a campaign with this name for these people. Ignored when campaignId is given.
searchIdstringNosearchId from prospects_search. Preferred: resumes that preview for more people instead of starting over.
querystringNoPlain description of the audience, or a people-search URL the user pasted (runs as-is). Required when searchId is omitted (or pass filters).
filtersobjectNoExact filters when not using searchId. Pass appliedFilters from prospects_search.
maxLeadsnumberNoMaximum number of people to source and charge for. Defaults to 100, max 500.
fillToBudgetbooleanNoImport 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.

On this page