Clearbit (HubSpot) platform help — Person Enrichment, Company Enrichment, Reveal (IP-to-company), Prospector, Name to Domain, Form Shortening, Risk API, Breeze Intelligence, API & integrations. Use when lead enrichment returning incomplete data, Reveal not identifying website visitors, Prospector not finding the right contacts, Breeze Intelligence not working in HubSpot, form shortening not auto-filling fields, or API responses missing expected attributes. Do NOT use for enrichment strategy across tools (use /sales-enrich), intent/visitor identification strategy (use /sales-intent), building prospect lists across tools (use /sales-prospect-list), or lead scoring strategy (use /sales-lead-score).
Help the user with Clearbit platform questions — Person and Company Enrichment, Reveal IP intelligence, Prospector contact search, Name to Domain, Form Shortening, Risk API, Breeze Intelligence (HubSpot), and API integration.
Important context: Clearbit was acquired by HubSpot in December 2023 and rebranded as Breeze Intelligence within HubSpot. The standalone API still works, but product investment has shifted to HubSpot. Non-HubSpot users can still use the API directly; HubSpot users get Breeze Intelligence as an add-on.
If references/learnings.md exists, read it first for accumulated knowledge.
What area of Clearbit do you need help with?
What's your CRM/stack?
What's your goal?
If the question is about enrichment strategy across tools (not Clearbit-specific) — hand off: "This is an enrichment strategy question — run: /sales-enrich {user's original question}"
If the question is about intent signals and visitor identification strategy — hand off: "This is an intent signal strategy question — run: /sales-intent {user's original question}"
If the question is about building prospect lists across tools — hand off: "This is a prospect list building question — run: /sales-prospect-list {user's original question}"
If the question is about lead scoring model design — hand off: "This is a lead scoring strategy question — run: /sales-lead-score {user's original question}"
If the question is about CRM data quality and dedup — hand off: "This is a CRM data hygiene question — run: /sales-data-hygiene {user's original question}"
If the question is about connecting Clearbit to other tools — hand off: "This is a tool integration question — run: /sales-integration {user's original question}"
Otherwise, answer directly using the reference below.
Read references/platform-guide.md for detailed module documentation, pricing, integrations, and data model.
You no longer need the platform guide details — focus on the user's specific situation.
-stream.clearbit.com) for real-time; use standard endpoints + webhooks for batch/asyncperson.clearbit.com/v2/combined/find?email={email} returns both person and company in one callBest-effort from research — review these, especially items about plan-gated features and pricing that may be outdated.
HubSpot lock-in: Breeze Intelligence requires a paid HubSpot subscription. If you use Salesforce, Pipedrive, or any other CRM, you must use the standalone Clearbit API (not Breeze Intelligence). The standalone API's future is uncertain post-acquisition.
Credits don't roll over: Breeze Intelligence credits reset monthly. If you buy 1,000 credits and use 200, you lose 800. Right-size your plan carefully.
Reveal identifies companies, not people: The Reveal API returns company data from IP addresses, not individual visitors. You still need Prospector or another tool to find the specific contact at that company.
SDK deprecation: The official Ruby, Node.js, Python, and Go SDKs are all deprecated. Clearbit recommends direct HTTP requests. If your code uses these SDKs, plan migration to direct API calls.
202 responses require webhooks: Standard (non-streaming) enrichment endpoints return 202 if the person/company isn't in Clearbit's cache. You must configure a webhook URL to receive async results, or use the streaming endpoints which hold the connection open.
Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.
/sales-enrich — Enrichment strategy across tools (Clearbit, ZoomInfo, Apollo, Clay, etc.)/sales-intent — Buying signals and visitor identification strategy (Reveal feeds intent models)/sales-prospect-list — Build prospect lists across tools (Prospector is one option)/sales-lead-score — Design lead scoring models using enrichment data/sales-data-hygiene — CRM data quality, dedup, enrichment automation/sales-audience-growth — Form optimization and conversion (form shortening)/sales-integration — Connect Clearbit to CRM, marketing automation, and other tools/sales-zoominfo — ZoomInfo platform (primary competitor for enterprise enrichment)/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skills sales-doUser says: "I want to enrich new leads in real-time as they submit our website form — how do I set up Clearbit for this?"
Skill does: Recommends the Combined streaming endpoint (person-stream.clearbit.com/v2/combined/find), explains authentication, walks through the response structure, shows how to map key fields (company size, revenue, industry, title) to CRM properties, and suggests caching results to avoid redundant API calls
Result: Working real-time enrichment pipeline that enriches leads on form submission
User says: "We want to know when our target accounts are browsing our pricing page so sales can follow up" Skill does: Sets up Reveal API integration, explains IP-to-company matching, configures Slack alerts for target account visits filtered by page URL, recommends combining with Prospector to find the right contact, and suggests adding visit data to CRM account records Result: Sales team gets real-time alerts when target accounts show buying intent on the website
User says: "We just got HubSpot Professional and want to use Clearbit enrichment — how do I set up Breeze Intelligence?" Skill does: Walks through purchasing credits, enabling auto-enrichment for new contacts/companies, configuring form shortening on HubSpot forms, mapping enrichment fields to HubSpot properties, and monitoring credit usage to avoid waste Result: HubSpot CRM automatically enriches every new contact with firmographic and demographic data
Symptom: API call returns HTTP 202 instead of enrichment data
Cause: The person or company isn't in Clearbit's cache and needs to be looked up asynchronously
Solution: Either switch to the streaming endpoint (person-stream.clearbit.com) which holds the connection open for up to 60 seconds, or configure a webhook URL in your Clearbit account settings to receive results when the async lookup completes.
Symptom: The Reveal API returns no company match for a large percentage of website visitors Cause: Reveal can only match IP addresses that belong to known business ISPs. Residential IPs, VPNs, and mobile networks can't be matched to companies. Match rates are typically 20-30% of total traffic. Solution: This is expected behavior — focus on the matched visits rather than the miss rate. Combine with UTM tracking, form fills, and other signals to identify the remaining visitors.
Symptom: Monthly credits run out before the billing cycle resets Cause: Auto-enrichment is enriching every new contact, including low-value leads from form spam, imported lists, or internal test records Solution: Set up enrichment rules to only enrich contacts that meet minimum criteria (e.g., business email domain, specific form source, lead score threshold). Disable auto-enrichment for imported lists and use manual bulk enrichment instead.