Skip to main content
POST
Start a lead search

Authorizations

Authorization
string
header
required

A ManyPI API key (mpi_...) from Settings → API keys, or an OAuth 2.1 access token obtained through the MCP consent flow.

Body

application/json
criteria
object

The structured search. The description does most of the work; the rest is what the agent enforces.

profile_id
string<uuid>

Re-run a saved search. Its criteria are used unless criteria overrides them.

seed_lead_ids
string<uuid>[]

Seed the search from existing leads ("find similar").

Maximum array length: 50
save
boolean
default:true

Persist as a reusable saved search.

name
string
Maximum string length: 120
kind
enum<string>
Available options:
icp,
similar

Response

The run was created.

run_id
string<uuid>
conversation_id
string<uuid>
status
string
count
integer

Leads the run will actually try to save, after clamping.

profile
object | null
clamped
object

Present only when count was reduced to fit the plan.