ICP Profiles
Ideal Customer Profiles define who you're targeting. The AI uses these to generate relevant prospects automatically.
Plan requirement: ICP Profiles require Pro+ plan. Requires icp:write scope to create.
GET
/icp-profilesList all ICP profiles for your organization.
curl "https://kashew.ai/api/v1/icp-profiles" \
-H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..."200
{
"profiles": [{
"id": "uuid",
"name": "Enterprise SaaS — North America",
"description": "Mid-to-large SaaS companies",
"is_active": true,
"target_industries": ["SaaS", "Technology"],
"target_job_titles": ["VP Sales", "CTO"],
"target_countries": ["United States", "Canada"],
"daily_prospect_limit": 10,
"created_at": "2026-05-01T10:00:00Z"
}]
}POST
/icp-profilesCreate a new ICP profile. The AI will use this to generate matching prospects.
Request Body
{
"name": "Enterprise SaaS — North America",
"description": "Mid-to-large SaaS companies in North America",
"is_active": true,
"target_industries": ["SaaS", "Technology"],
"target_company_sizes": ["51-200", "201-500"],
"target_job_titles": ["VP Sales", "CTO", "Head of Growth"],
"target_seniority_levels": ["VP", "Director", "C-Suite"],
"target_departments": ["Sales", "Engineering"],
"target_countries": ["United States", "Canada"],
"min_confidence_score": 0.7,
"daily_prospect_limit": 10,
"generation_schedule": "daily"
}201
{ "id": "uuid", "status": "created" }ICP Profile Fields
| Field | Required | Description |
|---|---|---|
| name | yes | Profile name |
| target_industries | recommended | Array of industry strings |
| target_job_titles | recommended | Array of job title strings |
| target_company_sizes | recommended | e.g. "1-10", "11-50", "51-200", "201-500", "500+" |
| target_seniority_levels | recommended | VP, Director, C-Suite, Manager, Individual Contributor |
| target_countries | recommended | Array of country names |
| min_confidence_score | no | 0.0–1.0, default 0.7 |
| daily_prospect_limit | no | Max prospects generated per day (default: 10) |
| is_active | no | Whether to generate prospects (default: true) |