Create ICP

Create a new Ideal Customer Profile (ICP).

An ICP defines the target company and people segments for signal discovery.

Before calling this endpoint, call GET /api/v1/icp/options to retrieve all valid values for employee_ranges, funding stages, locations, and sub_locations.

Required fields:

• name: A descriptive name for the ICP (e.g., “Mid-market SaaS companies in US”).
• target_roles: List of job titles or role descriptions to target. Examples: [“Head of Engineering”, “VP of Product”, “Senior Leaders in Engineering & Product”].
• employee_ranges: Company size filters. Provide one or more range labels from the employee_ranges list returned by /api/v1/icp/options. Multiple ranges are collapsed to an overall min/max employee count internally.
• location: List of company HQ location codes. Use the value field from the locations list returned by /api/v1/icp/options (e.g., [“us”, “uk”, “ca”]).

Optional fields:

• min_funding / max_funding: Funding stage range. Both must be provided together. Use values from the funding_stages list returned by /api/v1/icp/options.
• employee_count_funding_config: How to combine employee count and funding criteria. Only valid when funding is set. Values: "AND" (company must match both employee count AND funding stage) or "OR" (company must match either). Omit or set to null if no combination logic is needed.
• sub_locations: US state or city codes. Use the value field from the sub_locations list returned by /api/v1/icp/options (e.g., [“ca”, “san-francisco-ca”, “ny”]). Only applicable when location is exclusively ["us"].
• people_locations: Geographic filter for target people. Use the value field from the people_locations list returned by /api/v1/icp/options (e.g., [“us”, “ca”]).
• people_sub_locations: Sub-region codes for people locations. Use the value field from the people_sub_locations list returned by /api/v1/icp/options (e.g., [“san-francisco-ca”, “austin-tx”]). Only applicable when people_locations is exclusively ["us"].