This guide walks you through how to push product usage metrics (like MAU or feature usage) into HubSpot, linked to the Company record.
This step happens outside of HubSpot. You’ll need to:
Extract product usage data from your internal systems
Aggregate it per customer account (e.g., workspace, org ID)
Prepare values like:
Monthly Active Users (MAU)
Projects Created
Last Login
% Feature Adoption
👉 Make sure each row has a unique identifier that also exists in HubSpot (like a Workspace ID, Customer ID, or domain).
Once the data is ready, you have two options to send it into HubSpot:
Create a custom property on the Company object (e.g., Workspace ID) and populate it for all customers via:
Manual entry
HubSpot import (CSV)
API
Create custom properties for metrics like monthly_active_users, #_bookings, last_login, etc.
Use the CRM API to:
Search for the company using your unique ID
Update properties with the usage metrics
This is a good alternative if you’re doing a one-off update or don’t want to use the API.
Your CSV should contain:
A column with your unique ID (e.g., Workspace ID)
Columns for each product usage property you want to update
Example:
| Workspace ID | Monthly Active Users | Last Login |
|---|---|---|
| WKS-001 | 132 | 2025-07-06 |
| WKS-002 | 48 | 2025-07-07 |
Go to Contacts > Companies > Import and:
Choose “File from computer”
Select Company object
Use “Update existing records”
Match on the Workspace ID property
This will update the relevant fields per company based on your file.
| Step | Description |
|---|---|
| Step 1 | Aggregate your product usage data by account |
| Step 2A (API) | Send data using HubSpot’s API using a unique ID match |
| Step 2B (CSV) | Upload a CSV file and update companies via HubSpot’s importer |
Let me know if you want a slide deck version or want to connect with someone who already built this integration.