Lantern HubSpot Integration: AEO pipeline attribution for B2B SaaS

What this does

The Lantern HubSpot integration is a two-way connection between Lantern's AI citation monitoring and HubSpot's CRM. Outbound: Lantern writes custom properties on Contact and Deal records (ai_source, ai_engine, ai_prompt, ai_cited_url) whenever an AI-referred session is captured. Inbound: Lantern reads HubSpot deal-stage transitions and closed-won amounts to roll pipeline dollars up against the original AI citation — producing a monthly AEO ROI number that ties back to prompts, engines, and specific cited pages.

How Lantern fits

HubSpot is the V1 CRM integration for Lantern. Salesforce ships V1.5 (Months 4-6). Pipedrive and Marketo are on the roadmap. If you run revenue out of HubSpot, the install is designed to be the quickest part of onboarding: OAuth in, Lantern auto-creates the custom properties, auto-installs the tracking JS snippet via your HubSpot tracking code slot, and publishes two workflows into your portal. First monthly ROI report arrives 30 days after install.

Setup preview

Install takes ~30 minutes end-to-end. The flow: (1) OAuth connect to HubSpot with the minimum scope set (crm.objects.contacts, crm.objects.deals, automation, content). (2) Lantern creates 7 custom properties on the Contact object and 4 on the Deal object. (3) Lantern publishes a tracking snippet into your HubSpot tracking code field. (4) Lantern installs two workflows: 'AI Source Persistence' on contact creation and 'Deal AEO Rollup' on deal stage changed. (5) Lantern backfills the last 90 days of sessions where document.referrer matched an AI hostname.

{
  "oauth_scopes": [
    "crm.objects.contacts.read",
    "crm.objects.contacts.write",
    "crm.objects.deals.read",
    "crm.objects.deals.write",
    "crm.schemas.contacts.write",
    "crm.schemas.deals.write",
    "automation",
    "content",
    "tracking"
  ],
  "read_only_fallback": [
    "crm.objects.contacts.read",
    "crm.objects.deals.read",
    "tracking"
  ]
}

Where this fits in the bigger picture

This page describes one specific surface inside HubSpot where Lantern's AEO pipeline attribution plugs in. The full integration stitches together across HubSpot Contacts, Deals, Workflows, Lists, Reports, Forms, CMS, and the Marketing/Sales/Service Hub stack. If you're evaluating where to start, the comparison hub has side-by-side comparisons of Lantern against Profound, Scrunch, Peec AI, AthenaHQ, and HubSpot's own AEO product — scored on the dimensions that matter for a CMO buyer (CRM integration depth, reporting quality, prompt-scaling economics).

If you're about to walk this work into a renewal review or budget conversation, the CFO's Guide to AEO Budget Defense has the memo template, the five-slide deck structure, the attribution-math cheat sheet, and the three most-common CFO objections with counter-arguments. It's the long-form companion that translates the technical HubSpot setup on this page into a defensible dollar number for finance.