Getting Started
Core concepts
The handful of objects that make up Hunch, and how they fit together.
Workspace
A workspace is your team's container, its Knowledge Base, ICP, signals, accounts, members, integrations, and billing all live inside it. Every API key and every piece of data is scoped to a single workspace.
Accounts
An account is a company Hunch is tracking for you. Each account has a status:
- Suggested, surfaced by discovery because it matches your ICP and shows a signal. Researched once when found, then left alone. Suggested accounts are free.
- Active, an account you've chosen to monitor. Activating one consumes a credit against your plan and puts the account into the ongoing monitoring cycle.
- Unqualified, didn't meet the criteria, or was rejected. Not monitored.
activecount. Discovered and suggested accounts don't cost anything until you activate them, so you can browse a large pool of matches and only spend credits on the ones you actually want to work.Signals
A signal is a buying trigger you define in plain English, for example, “Did this company appoint a new CRO in the last 90 days?” Hunch turns your plain-English description into a precise detector so it's applied consistently. Signals have a timeframe (how recent an event must be to count) and can be muted or made active.
See Signals for how to write good ones.
ICP (Ideal Customer Profile)
Your ICP describes who you sell to, industries, company size, geographies, buyer and champion titles, and discovery queries. Hunch derives it from your Knowledge Base and uses it to find net-new accounts and to score how well any company fits, independent of whether a signal fired.
Runs
A run is one execution of a signal against your accounts. Runs happen automatically, and you can also start one on demand from the app, the API, or an AI agent. Each run can find net-new companies, check your existing active accounts, or both. You can inspect runs and their results through the API.
Detections
When Hunch evaluates an account against a signal, it produces a detection (an account signal). If the signal is present, the detection carries the score (alpha), a headline, a narrative, a “why now” summary, the dated evidence with source links, and a drafted outreach message. If it's absent, the detection records that too, Hunch is deliberately strict and prefers a missed signal over a fabricated one.
Knowledge Base
The Knowledge Base is your company's profile, what you sell, to whom, and why you win. It's built by scraping your website and is fully editable. It grounds signal suggestions, ICP matching, and the tone of drafted outreach. See Knowledge Base.