Create an Ideal Customer Profile

POST

/v1/icps

Create a new Ideal Customer Profile (ICP) in the account. Creating an ICP also creates the custom feed that surfaces the companies matching it.

Credit Note: Creating an ICP does not consume credits.

INFO

Requires the icps:write OAuth2 scope.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Examples

A continent with an exclusionIndustry, size and country

European companies, excluding the DACH countries

{
    "data": {
        "attributes": {
            "filters": {
                "location": [
                    {
                        "display_value": "Europe",
                        "search_value": "europe",
                        "type": "continent"
                    },
                    {
                        "display_value": "DACH",
                        "negated": true,
                        "search_value": "dach",
                        "type": "world_region"
                    }
                ]
            },
            "name": "Europe excluding DACH"
        },
        "type": "icp"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

A continent with an exclusionIndustry, size and country

curl --location 'https://api.leadfeeder.com/v1/icps?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "attributes": {
            "filters": {
                "location": [
                    {
                        "display_value": "Europe",
                        "search_value": "europe",
                        "type": "continent"
                    },
                    {
                        "display_value": "DACH",
                        "negated": true,
                        "search_value": "dach",
                        "type": "world_region"
                    }
                ]
            },
            "name": "Europe excluding DACH"
        },
        "type": "icp"
    }
}'

Responses

🟢201Created

application/json

Success

Bodyapplication/json

Example

{
    "data": {
        "attributes": {
            "created_at": "2024-12-10T15:57:25.000Z",
            "filters": {
                "employee_count": [
                    {
                        "display_value": "201-500 employees",
                        "negated": false,
                        "search_value": "201-500"
                    }
                ],
                "industries": [
                    {
                        "display_value": "Software Development",
                        "negated": false,
                        "search_value": "1594.6"
                    }
                ],
                "location": [
                    {
                        "display_value": "United States",
                        "negated": false,
                        "search_value": "US",
                        "type": "country_code"
                    }
                ]
            },
            "name": "US Tech Companies"
        },
        "id": "6080",
        "type": "icp"
    },
    "meta": {
        "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

🟠429

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-09-08 13:18:45

Retrieve Ideal Customer Profiles