HubSpot is the system of record for event-sourced pipeline.
Contacts, Deals, Timeline.
OAuth. Contacts upserted by email. Timeline events for every touch (badge scan, voice note, booked meeting). Event-sourced pipeline on the Deal custom property RevOps already queries.
How the HubSpot integration works
Four steps, each pointed at a specific HubSpot object. No forcing the HubSpot data model into a Salesforce shape.
Connect via OAuth
OAuth install scoped to the Hubs you use. No private app to build, no API key to rotate. Your HubSpot admin approves the scope list once and Luminik stores a refresh token. Reconnect is a two-click flow if scopes change.
Scopes, crm.objects.contacts, crm.objects.deals, timeline Contact and deal mapping
Every attendee becomes or updates a HubSpot Contact by email match. Ranked targets get a custom property you own. Booked meetings become Engagements on the Contact and the Deal. Mapping happens in a preview UI before a single record writes.
Configurable per-org, per-property Timeline events for every touch
Luminik writes a Timeline event for every event touch so the Contact record tells the whole story, badge scan, voice note, AI summary, booked meeting. Your AEs open the Contact and see the thread without leaving HubSpot.
Custom Timeline event type per org Attribution on Deal Source
Within 48 hours of event close, Luminik writes event-sourced pipeline to a Deal Source property you nominate. Sourced and influenced can be two properties or one, your call during setup. Marketing Hub edition users can drive a workflow off the same property.
Custom Deal properties, named by your RevOps team What writes where
Default mapping below. Any row is editable during setup.
| Luminik field | HubSpot object / property |
|---|---|
| Attendee (ICP-matched) | Contact (upsert by email) |
| Event audience segment | Active List (one per event, named with event code) |
| ICP score + reason codes | Contact custom properties |
| Target-account boost | Contact property + Company association |
| Event touch | Timeline event on Contact (typed per event) |
| Voice note + AI summary | Engagement (Note) on Contact and Deal |
| Booked meeting | Engagement (Meeting), associated to Deal if matched |
| Sourced pipeline | Custom Deal property you pick |
| Influenced pipeline | Custom Deal property you pick |
Who this is for
Marketing teams that run on HubSpot workflows
Your automation fires off Contact properties and Deal Source fields. Luminik writes those after every event so the workflows pick up without any manual step.
RevOps on Sales + Marketing Hub
You want Deal Source split across sourced and influenced, and Timeline events so the AE opens a Contact and sees the full story before they pick up the phone.
Demand gen teams with a QBR coming up
Every event dollar tied to a Deal property the CMO can pull up. No post-show spreadsheet to reconcile. The number is already in HubSpot by Saturday.
We needed event data inside HubSpot. Luminik writes Timeline events on the Contact and a source property on the Deal. Our workflows do the rest.
HubSpot-specific questions
Which HubSpot editions are supported?
Sales Hub Professional or Enterprise for Deal writeback. Marketing Hub Professional or Enterprise is needed if you want Luminik's Timeline events to drive Marketing workflows. Service Hub is supported for Engagement writeback. Starter tiers work for Contact sync only.
How does this interact with HubSpot's marketing-contacts billing?
Luminik writes attendees as Contacts but does not flip the Marketing Contact toggle. You choose which segments become Marketing Contacts through HubSpot workflows, same as any other source. We don't touch the billing axis.
What about the v1 Lists API sunset in April 2026?
Luminik is on HubSpot's v3 API throughout. The v1 Lists deprecation doesn't affect our integration. We monitor HubSpot API change-logs and version bumps are tracked as infrastructure work on our side.
Can we sync back into HubSpot workflows automatically?
Yes, once a Contact or Deal property is written, any HubSpot workflow that listens on that property fires on the normal cadence. Luminik doesn't wait for the workflow, and the workflow doesn't wait for Luminik. They're independent.
Will this pollute my Deal records?
No. Three-tier matching (email, domain, company name) attaches attribution where the match is HIGH or MEDIUM confidence. LOW-confidence matches are saved as suggestions for your RevOps team to review before anything writes to the Deal. You decide what lands on the record.
See the HubSpot writeback on your portal.
20 minutes. Connect a sandbox portal, do the mapping live, watch a Contact and a Deal get written in front of you. Then we confirm which tier fits.