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-profiles

List 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-profiles

Create 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

FieldRequiredDescription
nameyesProfile name
target_industriesrecommendedArray of industry strings
target_job_titlesrecommendedArray of job title strings
target_company_sizesrecommendede.g. "1-10", "11-50", "51-200", "201-500", "500+"
target_seniority_levelsrecommendedVP, Director, C-Suite, Manager, Individual Contributor
target_countriesrecommendedArray of country names
min_confidence_scoreno0.0–1.0, default 0.7
daily_prospect_limitnoMax prospects generated per day (default: 10)
is_activenoWhether to generate prospects (default: true)