validation. run. start
Start a validation run to find market problems, assess the top one, and draft a landing page and three cold emails.
Charged by the tools it calls. problem.mine 800, market.size.assess 800, icp.search 6 per company. About 1,900 in total. The balance must cover 2,050 to start.
Example prompt
Send this to your AI app when Heelo is connected:
Run a validation for small accounting firms in the US: find their biggest problems and check if they already pay to solve the top one.
Input fields
| Field | Type | Description |
|---|---|---|
domainRequired | string | The market to explore, e.g. 'tools for dentists' |
geography | array of string | string | Where the target companies are; default ['United States'] (only US is e-mailed) |
physical_address | string | Your postal address; every e-mail carries it |
landing_site_id | string | One of your Loop I site ids |
end_user_id | string | Your end user, for saved details |
scan_id | string | The job_id of a problem.mine scan of yours that is done: the run takes its problems and starts no scan of its own |
problem_id | string | With scan_id: the problem of that scan to assess (an id from its problems). Leave it out, and Heelo picks the top-ranked problem whose audience is companies |
Code
The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/validation.run.start/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"domain": "small accounting firms in the US",
}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/validation.run.start/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"domain": "small accounting firms in the US"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());