Account watchlist
Polling asks "anything new?" a hundred times and is wrong ninety-nine of them. A watch answers once, at the exact moment a named account starts hiring the function the user sells to. That moment is the whole value: first voice, not ninth.
Ask for it like this
- "Tell me when Monzo starts hiring engineers"
- "Watch these 20 accounts for sales roles"
- "What changed in my patch since yesterday?"
How it works
Push setup, two calls:
POST /v1/webhooks register the delivery target once
POST /v1/watches company_id or a criteria set, plus event_types
Header X-API-Key from $REQBEAT_API_KEY. One POST /v1/quickstart (webhook_url + domain) wires a working watch and webhook in a single call if the user prefers. Missed deliveries replay via /v1/webhook-deliveries/replay; signature verification is in the API reference.
Pull path, no webhook needed:
GET /v1/events the event feed, filter by company_id or event_type
get_changes (MCP tool) ledger diff with a since-cursor: only what changed
For a daily diff, store the cursor between runs and pull only the delta.
Output format
For setup: confirm what is watched (companies or criteria), which events, and where deliveries go. For a diff pull: a short list of changes, each with company, event type, and date, newest first, followed by "nothing else changed since {cursor date}".
Rules
- Free tier holds 3 concurrent watches; deleting one returns the slot. Say so before creating a fourth.
- Delivered changes on free tier cap at 50 per billing month, forward-only, no backfill. Quote this rather than letting the user discover it.
- A watch that fires belongs in the funnel: offer
pre-call-briefon the company, thensignal-first-outreachfor the first touch. - Never print the key, and never register a webhook target the user did not name.