Skip to content

Docs / All tools / Loop IV: Validation

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

FieldTypeDescription
domainRequiredstringThe market to explore, e.g. 'tools for dentists'
geographyarray of string | stringWhere the target companies are; default ['United States'] (only US is e-mailed)
physical_addressstringYour postal address; every e-mail carries it
landing_site_idstringOne of your Loop I site ids
end_user_idstringYour end user, for saved details
scan_idstringThe 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_idstringWith 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())