MailMoo
Open MailMoo
DocumentationAPI reference
EndpointsProspecting

Add prospects to a campaign

Finds leads matching the audience and adds them to a campaign, either an existing one or a new one created for them. This spends credits, one charge per lead sourced, and cannot be undone. Check the audience first with leadFinder.searchProspects. Duplicates already in the campaign are skipped and not charged for.

POST/leadFinder.addProspectsToCampaign

Authorization

bearerAuth
AuthorizationBearer <token>

Enter your MailMoo API key (format: sk_live_...)

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/leadFinder.addProspectsToCampaign" \  -H "Content-Type: application/json" \  -d '{}'
{  "campaignId": "13f8bf6d-dc27-4a04-bffe-6e5b13c19ddf",  "campaignName": "string",  "createdCampaign": true,  "appliedFilters": {    "property1": null,    "property2": null  },  "requestedLeadCount": 0,  "limitedByCredits": true,  "addedCount": 0,  "skippedDuplicates": 0,  "usedCredits": 0}

Search for new prospects POST

Searches for new leads who are not yet in the workspace. Returns an approximate match count plus a small sample so you can check the audience before importing it. Free, and returns no contact details. Use campaigns.leads.search instead to search people already in the workspace. Import with leadFinder.addProspectsToCampaign, which is the step that spends credits.