Request research
create_research_requestStarts a saved-criteria agency research workflow to find contacts for up to 200 agencies within budget, using an enabled agent and optional campaign ID; deep mode adds public-source checks.
Instructions
Starts the saved-criteria agency research workflow: up to 200 agencies and 5,000 contacts per agency, within the account's budget, using the account's enabled agent and an optional campaign_id for one of the user's own saved lists. Research uses the contact database and opened public sources; research_depth=deep adds broader public-source checks. Shared read access to another owner's list does not allow research on it. Returns the backend acknowledgment with the goal id. Delivery follows backend policy.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agencies": "<agencies>",
"idempotency_key": "<idempotency_key>"
},
"name": "create_research_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| title | No | ||
| agencies | Yes | ||
| config_id | No | ||
| campaign_id | No | ||
| research_depth | No | standard | |
| idempotency_key | Yes |