ICP Refinement Agent

Turn closed-won deal patterns into a living ICP that evolves with your market.

Monthly AI-powered ICP analysis from HubSpot closed-won deals with Apollo.io enrichment. 4-agent AGGREGATE pattern produces 6-dimension ICP report with pattern confidence ratings and period-over-period comparison. Notion ICP report + HubSpot scoring recommendations.

Last updated March 16, 2026

B2B sales teams spend 65% of their time on non-selling activities, with manual lead qualification consuming the largest share. As contact databases grow past 10K records and buying committees expand to 6-10 stakeholders, human-only qualification cannot keep pace. Automated scoring with transparent, auditable criteria lets reps focus on conversations instead of spreadsheets.

triggerMonthly01FetcherHubSpot API02EnricherApollo.io API03Analyst6 Dimensions04FormatterICP ReportNotionICP ReportHubSpotScoring Task

Four Agents. Six Dimensions. A Living ICP That Evolves With Your Market.

Fetcher

Step 1Fetcher

Schedule + Code

Schedule Trigger fires monthly (1st 09:00 UTC) or manual Webhook for on-demand runs. Fetcher paginates HubSpot API for closed-won deals over a configurable 90-day lookback window plus a prior 90-day comparison period. Collects associated company and contact data for each deal.

Enricher

Step 2Enricher

Code-only

What does Enricher actually decide? Augments company profiles via Apollo.io API with firmographics, technographics, and growth signals. Conditional — toggle INCLUDE_APOLLO_ENRICHMENT to skip when Apollo credits are limited. Rate-limited with SplitInBatches and retry backoff.

Analyst

Step 3Analyst

Tier 2 Classification

This step exists because raw data alone is not enough. the analysis model receives ONE aggregate call with all enriched deal data. Produces 6-dimension ICP analysis: company_size, industry_vertical, tech_stack, growth_stage, buyer_persona, and deal_dynamics. Each dimension includes pattern confidence ratings (HIGH/MEDIUM/LOW) and period-over-period comparison showing how your ICP is shifting.

Formatter

Step 4Formatter

Tier 2 Classification

Without this step, upstream analysis sits idle. the analysis model generates a Notion ICP report page with dimension sections, confidence badges, and shift indicators. Also creates a HubSpot task with scoring adjustment recommendations so your lead qualification criteria stay current.The web search API fee is $0.03. The token cost from 30K-40K injected context tokens adds $0.06. The search fee is one-third of actual cost.

That's the full pipeline. Here's what it intentionally does NOT do — and why those boundaries exist.

What It Does NOT Do

×

Does not score individual leads — that is what Inbound Lead Qualifier does

×

Does not prospect against ICP criteria — that is what Outbound Prospecting Agent does

×

Does not forecast pipeline revenue — that is what RevOps Forecast Intelligence Agent does

×

Does not modify HubSpot deal data or contact records — read-only analysis with task output

×

Does not scrape external websites — all data from HubSpot API and Apollo.io API

×

Does not analyze lost deals — focuses exclusively on closed-won patterns

With those boundaries clear, here's everything that ships when you purchase.

The Complete Customer Success Bundle

6 files.

CHANGELOG.mdVersion history
README.mdSetup and configuration guide
docs/TDD.mdTechnical Design Document
icp_refinement_agent_v1.0.0.jsonn8n workflow (main pipeline)
system_prompts/analyst_system_prompt.mdAnalyst system prompt
system_prompts/formatter_system_prompt.mdFormatter system prompt

The technical specifications below are ITP-measured, not estimated.

Tested. Measured. Documented.

Every metric is Independent Test Protocol (ITP)-measured. The ICP Refinement Agent turns HubSpot closed-won deal patterns into a living ICP — analyzing 6 dimensions with pattern confidence ratings, period-over-period comparison, and scoring recommendations at $0.28/run.

Agent Architecture

Fetcher (code-only) → Enricher (code-only) → Analyst (Sonnet 4.6) → Formatter (Sonnet 4.6)

Required Credentials

HubSpot (OAuth2), Apollo.io (httpHeaderAuth), Notion (httpHeaderAuth), Anthropic API

Bundle Contents

7

Cost per Run

$0.28/run (avg)

n8n Compatibility

2.7.5

Tested on n8n v2.7.5, March 2026

ICP Refinement Agent v1.0.0 — Technical Reference━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━Architecture: 29 n8n nodes, 4 agents (Fetcher → Enricher → Analyst → Formatter)Trigger:      Schedule (monthly, 1st 09:00 UTC) or manual WebhookInput:        HubSpot API — closed-won deals with company + contact dataEnrichment:   Apollo.io API — firmographics, technographics, growth signals (optional)Intelligence: Sonnet 4.6 (Analyst ICP analysis + Formatter report generation)Output:       Notion (ICP report page) + HubSpot (scoring task)Cost:         $0.28/run (ITP-measured average)ITP:          8 variations, 14/14 milestones PASSBQS:          12/12 PASSTool A:       HubSpot (input — closed-won deal data via OAuth2 API)Tool B:       Apollo.io (enrichment — firmographics via httpHeaderAuth API)Tool C:       Notion (output — ICP report page via httpHeaderAuth API)Intelligence: 6-dimension ICP taxonomy + AGGREGATE pattern (single Analyst call)Cost Value:   0.28

What You'll Need

Platform

n8n 2.7.5+

Est. Monthly API Cost

$0.28/month (monthly runs) + HubSpot/Apollo.io/Notion included tiers

Credentials Required

  • Anthropic API
  • HubSpot (OAuth2)
  • Apollo.io (httpHeaderAuth)
  • Notion (httpHeaderAuth, Bearer prefix)

Services

  • HubSpot account (OAuth2 with deals, companies, contacts scopes)
  • Apollo.io API key
  • Notion workspace (integration token with Bearer prefix)
  • Anthropic API key

Setup Track

Quick Start

~15 min

All credentials live, n8n running

Full Setup

1–2 hrs

Needs API config + tables

From Scratch

2–4 hrs

No n8n, no credentials

ICP Refinement Agent v1.0.0

$249

one-time purchase

What you get:

  • ITP-tested 29-node n8n workflow — import and deploy
  • Monthly Schedule Trigger (1st 09:00 UTC) or manual Webhook for on-demand runs
  • HubSpot API pagination for closed-won deals with company and contact data
  • 90-day lookback + 90-day prior comparison for trend detection
  • 6-dimension ICP taxonomy: company_size, industry_vertical, tech_stack, growth_stage, buyer_persona, deal_dynamics
  • Pattern confidence ratings: HIGH (>70% deal match), MEDIUM (40–70%), LOW (<40%)
  • Period-over-period comparison showing how your ICP is shifting
  • Apollo.io firmographic enrichment (conditional — toggle on/off)
  • Notion ICP report with dimension sections and confidence badges
  • HubSpot task with scoring adjustment recommendations
  • AGGREGATE architecture: single Analyst + Formatter calls — $0.28/run regardless of deal count
  • Dual the analysis model: no Opus required
  • ITP 8 variations, 14/14 milestones, $0.28/run measured
  • All sales final after download

Frequently Asked Questions

How does it differ from Inbound Lead Qualifier?+

Complementary products covering different sides of lead qualification. ILQ scores individual inbound leads against a static ICP definition. ICRA refines the ICP itself from closed-won deal patterns.

What are the six ICP dimensions?+

Company Size — employee ranges, revenue bands, sweet-spot identification. Industry Vertical — dominant verticals, emerging verticals, win rate concentration. Tech Stack — common technologies, technology clusters correlated with wins.

How does pattern confidence work?+

Each dimension is scored by deal match percentage. HIGH confidence (>70% of deals match the pattern) means the dimension is a strong ICP signal. MEDIUM (40–70%) means emerging or mixed signal.

Can I run it without Apollo.io?+

Yes. Set INCLUDE_APOLLO_ENRICHMENT to false in the Config Loader. The Analyst still receives HubSpot deal, company, and contact data — enough for company_size, industry_vertical, buyer_persona, and deal_dynamics.

How often should I run it?+

Monthly is the default (1st of each month at 09:00 UTC). This balances having enough new closed-won deals for meaningful analysis against catching ICP shifts quickly. You can also trigger it manually via Webhook after a big quarter close or whenever you suspect your ICP is changing.

Why is it $0.28/run?+

AGGREGATE architecture. Instead of analyzing deals individually, all deal data is assembled by code-only nodes and sent to the Analyst in a single call. The Formatter also receives one call.

Does it use web scraping?+

No. All data comes from the HubSpot API (deals, companies, contacts) and Apollo.io API (firmographics, technographics). No web_search, no external scraping.

How does it differ from Outbound Prospecting Agent?+

Different purposes using shared data sources. OPA uses Apollo.io to find and prospect against your current ICP criteria. ICRA uses HubSpot closed-won data (optionally enriched by Apollo.io) to refine what those ICP criteria should be.

Is there a refund policy?+

All sales are final after download. Review the Blueprint Dependency Matrix and prerequisites before purchase. Questions?

Read the full guide →

Related Blueprints