Hi everyone, I am an integration developer currently working on a project to help teams with productivity and auditing. I have been going through the API documentation and forums but I cannot find a clear way to track internal user behavior within the CRM.
Specifically, we need to be able to pull data on when an employee simply views a contact or a deal record, opens a document in the file manager, or moves between different pages in the portal. I also need to know if it is possible to get session duration or time spent on a specific record via API.
Standard audit logs seem to only show changes like creates or updates, but we need these micro-interactions and view events for our tool to work. Is there a specific endpoint or perhaps a private beta that allows access to these raw internal activity logs? Any advice on how to capture this behavioral data programmatically would be really helpful. Thanks!
Hey @NShynkar and welcome, it’s a pleasure to have you here!
Thanks for reaching out to the HubSpot Community!
Did you check these resources to see if it fits for your use case?
- Account activity API
- Retrieve login activity
I’d love to put you in touch with our Top Experts: Hi @Anton, @SteveHTM and @zach_threadint do you have suggestions to help @NShynkar, please?
Have a wonderful day and thanks so much!
Bérangère
Hey @NShynkar,
I wanted to reach out regarding this inquiry. Unfortunately, what you’re looking for is not available through the HubSpot API. Here’s what we found:
Our audit logs API (Enterprise only) tracks write actions - CRM object creation, property value updates, content publishing, security activity, and similar events. It does not capture passive interactions like:
-Record views (viewing a contact/deal without editing)
-File manager document opens
-Page navigation within the portal
-Session duration or time-on-record
The login activity endpoint can tell you when users logged in, but not what they did inside the portal beyond write actions.
There is unfortunately no documented endpoint, private beta, or workaround in the current API documentation for tracking these micro-interactions. HubSpot simply doesn’t expose internal “read” or “view” events programmatically.
What you can do:
Submit a feature request via the Developer Feedback form!
If you need this for compliance/auditing, contact HubSpot support to ask if any internal tooling exists for Enterprise accounts.
I hope this helps!
Shane, Senior Community Moderator