Understand object property snapshots for events

Events are data points that capture a specific action or occurrence at a particular moment in time (e.g., form submission, SMS message sent, page view.) Unlike a record object, which represents the current state of a process or relationship, an event occurrence represents a singular point in time. This distinction is crucial for analyzing historical activity, tracking changes over time, and identifying trends. 

Event types

Ad 

• Ad interactions: the time when a visitor engaged with an ad connected to the HubSpot account. HubSpot can capture ad interactions that occurred from anonymous visitors. In cases where a lead engages with an ad without visiting your website, these interactions can still be tracked as part of ad performance but might not be categorized as a "Visit" for lead scoring.

Call

• Calls started: the time when the start of a call with a contact began. Use Calls started to measure whether a rep placed a call with a contact. This event captures a call whether or not it's outbound (i.e., began on the contact record or in the conversations inbox) or inbound (i.e., the user called in and the call was logged to their CRM record).
• Calls ended: the time of the end of a call with a contact. This event captures a call whether or not it's outbound (i.e., began on the contact record or in the conversations inbox) or inbound (i.e., the user called in and the call was logged to their CRM record).

Learn more about using calling in HubSpot.

Campaigns

• Campaign ID: populates the campaign that the interaction is associated with.

• Marketing campaign influences: contacts that have engaged with assets related to a campaign.

Learn more about using campaigns in HubSpot.

CTAs

• CTA views: the time when a visitor or contact viewed a CTA. HubSpot can track CTA views regardless of whether the person is a contact in your HubSpot account (i.e., anonymous visitors).
• CTA clicks: the time when a visitor or contact clicked a CTA. HubSpot can track CTA clicks regardless of whether the person is a contact in your HubSpot account (i.e., anonymous visitors).

Learn more about using CTAs in HubSpot.

Deals

• Deal stage: populates deal stage data from any of your pipelines.

Documents

• Contacts finished viewing documents: the time when a contact finished viewing a document.

• Contacts viewed documents: the time when a contact began viewing a document.

• Documents shared with contacts: the time when a HubSpot user shared a document with a contact. This event is tracked when a document is sent to a contact through an email or sequence where the user's inbox is connected to HubSpot.

Please note: HubSpot's email tracking feature doesn't allow you to see who forwarded a document to unknown email addresses if they are not already tracked or logged in the system. However, you can take to gather more information on who is viewing your documents through requiring an email to view a document.

Learn more about using documents in HubSpot.

Marketing events

Forms

• Form view: the time when a browser loaded a form on a screen, meaning the visitor scrolled and could view the form. HubSpot can capture form views that happened from anonymous visitors
• Form interaction: the time when a visitor began filling out a form. This event is captured when someone clicked into the form and has begun to fill out the form. HubSpot is able to capture form interactions from anonymous visitors.
• Form pop up view: the time when a visitor's browser loaded a pop-up form on their screen. This is specific to pop up forms and happens when the HubSpot tracking code registers that the user’s browser loaded the form. HubSpot can capture pop up form views that happened from anonymous visitors.
• Form submission: the time when someone successfully submitted a form. Form submissions require a user to provide their email address. Therefore, this event doesn't need to have the ‘include anonymous visitors’ option checked to see all form submissions in a journey report.

Learn more about using forms in HubSpot.

Marketing emails

• Clicked links in email: the time when a contact clicked a link in a marketing email.
• Emails bounced: the time when an email sent to a contact bounced.
• Emails delivered: the time when an email sent to a contact was delivered successfully.
• Opened emails: the time when a contact opened a marketing email.
• Reported spam: the time when a contact marked an email as spam.
• Updated email subscription status: the time when a contact updated their email subscription status.
• Attended marketing event: the date and time when a contact attended a marketing event.
• Canceled marketing event: the time when a contact canceled their registration for a marketing event invitation.
• Registered for marketing event: the time when a contact registered to attend an upcoming marketing event.

Learn more about marketing events in HubSpot.

Meetings

• Meetings booked: the time when a contact scheduled to attend a meeting. This can either happen when a contact books through a HubSpot meeting link or a HubSpot user schedules a meeting with a contact directly from the record.
• Meeting outcome changes: the time when a contact’s meeting outcome was changed or set. On the contact record, HubSpot users can set the meeting outcome. For example, the meeting outcome could be Scheduled, Completed, No show, etc. This event tracks when the value has been set.

Messaging

• Outbound message deliveries: the time when a WhatsApp message was delivered to a contact.
• Outbound message failures: the time when a WhatsApp message failed to deliver to a contact.
• Outbound message opens: the time when a contact opened a WhatsApp message.
• Outbound message sends: the time when a WhatsApp message was sent to a contact.

Learn more about using WhatsApp in HubSpot.

Payments

• Payment failed: the time when a contact’s recurring card or bank transfer payment failed to process.
• Payment initiated: the time when a contact’s bank transfer payment was initiated.
• Payment refund failed: the time when a contact’s payment refund failed to complete.
• Payment refund initiated: the time when a contact’s payment refund began.
• Payment refund succeeded: the time when a contact’s payment refund was completed.
• Payment succeeded: the time when a contact’s payment was successfully processed.

Learn more about using payments in HubSpot.

Sales email

• Sales email clicks: the time when a contact clicked a link in a one-to-one email.
• Sales email opens: the time when a contact opened a one-to-one email.
• Sales email replies: the time when a contact replied to a one-to-one email.
• Sales email sends: the time when a one-to-one email was sent to a contact.

Learn more about sending one-to-one email in HubSpot.

Sequences

• Contacts booked meetings through a sequence: the time when a contact booked a meeting through a sequence.
• Contacts enrolled in a sequence: the time when a HubSpot user enrolled a CRM into a sequence.
• Contacts unenrolled in a sequence: the time when a contact is no longer enrolled in a sequence. This could happen because the contact booked a meeting through the sequence, replied to an email in the sequence, unsubscribed from the sequence, or the sequence came to an end.
• Contacts unenrolled manually from sequence: the time when a HubSpot user manually unenrolled a contact from a sequence.
• Contacts unsubscribed from sequence email: the time when a contact unsubscribed from a one-to-one email while enrolled in a sequence.
• Sequence emails bounced: the time when an email sent to a contact bounced.
• Sequence steps executed: the time when a step was executed in a sequence.
• Sequences errored: the time when an error occurred in a sequence.
• Sequences finished: the time when a contact reached the final step of a sequence.

Learn more about using sequences in HubSpot.

SMS

• Link in short messages clicked: the time when a contact clicked a message in an SMS message.
• Short messages delivered: the time when an SMS message was delivered to a contact.
• Short messages dropped: the time when an SMS message was delivered to a contact but was dropped.
• Short messages failed: the time when an SMS message failed to deliver to a contact.
• Short message sent: the time when an SMS message was sent to a contact.

Learn more about using SMS messaging in HubSpot.

Web pages

• Pages visited: the time when a visitor viewed a page that was tracked by the HubSpot tracking code. HubSpot is able to capture page visits and interactions that happened from users who haven’t yet converted into a contact in your HubSpot.

What object properties are added to my events automatically?

HubSpot automatically captures and preserves Primary Associated Company and Lifecycle Stage for every standard contact event tracked in your account (e.g., form submissions, email opens, call starts, deal stage changes.) Instead of only seeing current property values when analyzing past events, you can now get snapshots of what a contact's company association and lifecycle stage were when each event occurred.

For example, when someone submits a form, the system records the form submission event, as well as which company they were associated with and what lifecycle stage they were in at that exact moment. This historical context gets stamped onto every HubSpot event permanently.

Please note: data collection for these properties starts August 27, 2025. Data isn't available retroactively for Primary associated company. 

Add snapshot properties to custom events

When creating custom events using the API, you have the option to enrich your event with your own object properties to capture historical data when custom events occur. When you add snapshot properties to existing events, data only populates from the time the property is added onward. 

To add snapshot properties to custom events:

1. In your HubSpot account, navigate to Data Management > Event Management.
2. Select an existing API event or click Create an event in the top right.
3. Click Track object changes.
4. In the object dropdown, select an option. Then, in the Object property dropdown, select an option. 
5. Click Next, and continue creating your event.
6. Click Done.

Where can you use these properties?

When building any report type with the event types, you'll have the option to select Primary Associated Company and Lifecycle Stage from the event of your choice.