Search for new prospects
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.
/leadFinder.searchProspectsAuthorization
bearerAuth 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.searchProspects" \ -H "Content-Type: application/json" \ -d '{}'{ "interpretation": "string", "appliedFilters": { "property1": null, "property2": null }, "matchCount": 0, "sample": [ { "fullName": "string", "jobTitle": "string", "companyName": "string", "location": "string", "industry": "string", "companySize": "string", "seniority": "string" } ]}Check remaining daily sending and search allowance GET
Returns how much daily sending allowance and daily search allowance each connected sender profile has left. Omit senderProfileId to list every sender profile with a connected account. A send or a post-engagement fetch may fail or queue when remaining is 0. Pass senderProfileId from this response to the other social endpoints.
Add prospects to a campaign POST
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.