Update ICP

curl --request PATCH \
  --url https://api.openfunnel.dev/api/v1/icp/update \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "id": 123,
  "name": "<string>",
  "target_roles": [
    "<string>"
  ],
  "employee_ranges": [
    "<string>"
  ],
  "min_funding": "<string>",
  "max_funding": "<string>",
  "employee_count_funding_config": "AND",
  "location": [
    "<string>"
  ],
  "sub_locations": [
    "<string>"
  ],
  "people_locations": [
    "<string>"
  ],
  "people_sub_locations": [
    "<string>"
  ]
}
'

{
  "icp": {
    "id": 123,
    "name": "<string>",
    "target_roles": [
      "<string>"
    ],
    "min_employee": 123,
    "max_employee": 123,
    "min_funding": "<string>",
    "max_funding": "<string>",
    "location": [
      "<string>"
    ],
    "sub_locations": [
      "<string>"
    ],
    "people_locations": [
      "<string>"
    ],
    "people_sub_locations": [
      "<string>"
    ],
    "employee_count_funding_config": "<string>"
  }
}

ICP

Update ICP

Update an existing Ideal Customer Profile (ICP).

Only the fields included in the request body will be modified — all other fields remain unchanged. The id field is always required to identify which ICP to update.

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:

id: The numeric ID of the ICP to update (returned by /api/v1/icp/list or /api/v1/icp/create).

Updatable fields (all optional — include only what you want to change):

name: A descriptive name for the ICP. Must be non-empty and unique among the user’s ICPs.
target_roles: List of job titles or role descriptions to target. Must contain at least one role if provided. Examples: [“Head of Engineering”, “VP of Product”].
employee_ranges: Company size filters. Provide one or more range labels from the employee_ranges list returned by /api/v1/icp/options. Must contain at least one range if provided.
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”]). Must contain at least one location if provided.
min_funding / max_funding: Funding stage bounds. Each can be updated independently. Set to null to clear (stored as "Any"). A value of "Any" means no constraint on that bound. 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. Values: "AND" or "OR". Only valid when funding is set. Set to null to clear.
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”]). Only applicable when location is exclusively ["us"]. Set to null or [] to clear. If changing location away from ["us"], you must also clear this field.
people_locations: Geographic filter for target people. Use the value field from the people_locations list returned by /api/v1/icp/options. Set to null or [] to clear.
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. Only applicable when people_locations is exclusively ["us"]. Set to null or [] to clear. If changing people_locations away from ["us"], you must also clear this field.

Cross-field validation:

sub_locations requires location to be ["us"] (checked against the final merged state, not just the request).
people_sub_locations requires people_locations to be ["us"].
employee_count_funding_config requires at least one of min_funding or max_funding to be a non-"Any" value.

PATCH

api

icp

update

Update ICP

curl --request PATCH \
  --url https://api.openfunnel.dev/api/v1/icp/update \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "id": 123,
  "name": "<string>",
  "target_roles": [
    "<string>"
  ],
  "employee_ranges": [
    "<string>"
  ],
  "min_funding": "<string>",
  "max_funding": "<string>",
  "employee_count_funding_config": "AND",
  "location": [
    "<string>"
  ],
  "sub_locations": [
    "<string>"
  ],
  "people_locations": [
    "<string>"
  ],
  "people_sub_locations": [
    "<string>"
  ]
}
'

{
  "icp": {
    "id": 123,
    "name": "<string>",
    "target_roles": [
      "<string>"
    ],
    "min_employee": 123,
    "max_employee": 123,
    "min_funding": "<string>",
    "max_funding": "<string>",
    "location": [
      "<string>"
    ],
    "sub_locations": [
      "<string>"
    ],
    "people_locations": [
      "<string>"
    ],
    "people_sub_locations": [
      "<string>"
    ],
    "employee_count_funding_config": "<string>"
  }
}

Headers

X-API-Key

string

required

X-User-ID

string

required

Body

application/json

integer

required

name

string | null

target_roles

string[] | null

employee_ranges

string[] | null

min_funding

string | null

max_funding

string | null

employee_count_funding_config

enum<string> | null

Available options:

AND,

OR

location

string[] | null

sub_locations

string[] | null

people_locations

string[] | null

people_sub_locations

string[] | null

Response

Successful Response

icp

ICPItem · object

required

Show child attributes

Create ICP Enrich Account

⌘I

Endpoints

Headers

Body

Response