ICP and exclusion events

Every event arrives in the same envelope: only data changes. The examples are fictional, and indented here for reading; the request body is compact JSON.

icp.updated

A new version of your ideal customer profile becomes active. Data: icp (ICP) and previous_version_id (null for the first version).

The ICP carries what changes a score. Your excluded companies are counted there; each one is sent as a blocklist.* event.

Example: icp.updated

{
  "id": "8bb9228c-7fef-4c0c-8363-c7da0cbd9dae",
  "type": "icp.updated",
  "created_at": "2026-10-05T12:06:56Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "icp": {
      "id": "e18507fb-b82e-48a9-8616-dbe2793d98dc",
      "created_at": "2026-10-05T12:06:56Z",
      "source": "MANUAL",
      "criteria": {
        "job_roles": [
          "Chief Financial Officer",
          "VP Finance",
          "Head of Finance",
          "Finance Director",
          "Controller",
          "Head of FP&A",
          "CEO",
          "COO"
        ],
        "seniorities": [
          "CXO",
          "Director",
          "Owner",
          "VP"
        ],
        "departments": [
          "Finance",
          "Founder/Executive",
          "Operations"
        ],
        "locations": [
          "United States",
          "Canada",
          "United Kingdom"
        ],
        "excluded_locations": [],
        "industries": [
          "Software Development",
          "Financial Services",
          "IT Services and IT Consulting"
        ],
        "excluded_industries": [],
        "company_types": [
          "Partnership",
          "Privately Held",
          "Public Company"
        ],
        "company_size": {
          "min": 50,
          "max": 1000
        }
      },
      "modes": {
        "job_role": "weighted",
        "location": "strict",
        "company_type": "weighted",
        "company_size": "weighted",
        "industry": "weighted"
      },
      "exclusions": {
        "excluded_job_titles": [
          "Intern",
          "Student",
          "Trainee",
          "Apprentice"
        ],
        "competitors": [
          "Litware Labs",
          "Proseware",
          "Tailspin Data"
        ],
        "custom": [
          "Freelancers and independent consultants",
          "Agencies and service providers",
          "Companies that resell planning software"
        ],
        "blocked_companies_count": 6
      },
      "switches": {
        "exclude_open_to_work": true,
        "exclude_students": true
      }
    },
    "previous_version_id": "020ed4ec-3c6e-4570-8121-d8529c89992c"
  }
}

blocklist.company_added

A company is excluded: its people are no longer turned into leads. Data: company ({name, linkedin_company_id, linkedin_url, domain}), reason and added_at. reason: self, affiliated, customer, competitor, manual or csv_import.

Example: blocklist.company_added

{
  "id": "d0ad9550-ce11-476c-8aa7-aee2f7c22b46",
  "type": "blocklist.company_added",
  "created_at": "2026-10-05T11:51:31Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "company": {
      "name": "Litware Labs",
      "linkedin_company_id": "73217627",
      "linkedin_url": "https://www.linkedin.com/company/litware-labs-example/",
      "domain": null
    },
    "reason": "competitor",
    "added_at": "2026-10-05T11:51:31Z"
  }
}

blocklist.company_removed

A company is no longer excluded. Data: company ({name, linkedin_company_id, linkedin_url, domain}) and removed_at.

Example: blocklist.company_removed

{
  "id": "670f1104-94bf-4ed9-8c60-f39114b6ab13",
  "type": "blocklist.company_removed",
  "created_at": "2026-10-06T08:10:07Z",
  "api_version": "2026-10-01",
  "workspace_id": "23e69bdb-4cd1-4822-802e-b38580e2f451",
  "data": {
    "company": {
      "name": "Litware Labs",
      "linkedin_company_id": "73217627",
      "linkedin_url": "https://www.linkedin.com/company/litware-labs-example/",
      "domain": null
    },
    "removed_at": "2026-10-20T09:00:00Z"
  }
}

Get started

Webhooks

Events

ICP and exclusion events

icp.updated

blocklist.company_added

blocklist.company_removed

​icp.updated

​blocklist.company_added

​blocklist.company_removed

icp.updated

blocklist.company_added

blocklist.company_removed