Documentation

Install

Click Install on HubSpot, choose your portal, and approve the requested scopes. The first scan starts about two seconds after installation and repeats every 24 hours.

What the scan does

  1. Reads your contacts (name, email, company, timestamps).
  2. Scores each contact's decay from its last_verified_at date (or create date), using a compounding ~3%/month decay model.
  3. Flags duplicate pairs by normalized email, name and company similarity.
  4. Re-verifies the least-fresh email addresses first, up to a per-run cap.
  5. Writes results back to four contact properties, created automatically on install.

Properties

freshness_confidence — 0 to 1, modeled probability the record is still correct.

freshness_band — fresh (≥0.9), aging (≥0.75), stale (≥0.55), critical (<0.55).

email_verdict — valid / invalid / catch-all / unknown from the latest verification.

last_verified_at — reset automatically whenever an email re-verifies as valid.

Recommended workflows

Suppress freshness_band = critical from marketing sends. Route stale contacts for re-enrichment. Review duplicate pairs before list imports.

Scopes

crm.objects.contacts.read/write — read contacts and write the four properties above. crm.schemas.contacts.write — create those properties on install. Nothing else is accessed.

Uninstall

Remove the app from Settings → Connected Apps in HubSpot. Scanning stops immediately; the properties and their values remain yours.