Kashew
Get StartedAPI ReferenceGuide

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.

Request
curl "https://kashew.ai/api/v1/icp-profiles" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..."
200Response
{
  "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"
}
201Response
{ "id": "uuid", "status": "created" }

ICP Profile Fields

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)