HubSpot integration for Dimension Labs
This brings in the message threads from HubSpot's conversations inbox and help desk workspace (chat, email and other connected channels), one conversation per thread, with the associated ticket id so you can join to ticket data. You run it on your side: a small script pulls from the HubSpot Conversations API and posts each message to the universal API.
- Platform
- HubSpot help desk and inbox
- Type
- Support desks
- Connects by
- Universal API
- Setup
- 5 steps
- Guide checked
- 2026-10-13, against HubSpot's documentation
Every HubSpot message, in the same shape as everything else.
Each record lands in the Dimension Labs conversation format, so Dimensions, reports and the agent work the same way as for every other source.
message text text richText holds the HTML version. Email messages can be cut to the latest reply: see truncationStatus.
thread associatedContactId userId HubSpot's internal contact id. Fall back to the thread id when there's no contact.
message direction incoming true when direction is INCOMING, false for OUTGOING.
thread id sessionId Prefix it, for example hubspot-176347007.
thread id conversationId Same value as sessionId.
message createdAt dimensionlabs_timestamp Convert with toMillis.
thread inboxId, status, threadAssociations.associatedTicketId; message channelId platformJson The ticket id lets you join to HubSpot ticket data. Leave out senders: it can hold names and email addresses.
5 steps. Then it runs on its own.
A small job on your side reads HubSpot through its API and posts each message to the Dimension Labs universal API. The guide gives the steps, the field mapping and the code. Run the job once for history, then every 15 minutes. A live source is enriched automatically every day; history is enriched with a backfill.
Rate limits, per HubSpot, for a private app: 100 requests per 10 seconds on Free and Starter, 190 on Professional and Enterprise. Daily limits per account are 250,000 on Free and Starter, 625,000 on Professional, and 1,000,000 on Enterprise (usage guidelines).
Open the full HubSpot guide ›- 01Get API access in HubSpot
- 02Pull new threads
- 03Map the fields
- 04Send it
- 05Run it
What you need
- A HubSpot super admin, to create a private app. HubSpot requires super admin access for private apps.
- The private app's access token, with the conversations.read scope.
- A Dimension Labs API key for a new Universal API source.
[03] What you can ask
Questions teams answer with HubSpot data.
- Which ticket themes come before a cancellation?
- What drives repeat contacts this month?
- Which issues take the most agent time, by reason?
HubSpot integration questions
Does Dimension Labs integrate with HubSpot?
Yes. A small job on your side reads HubSpot through its API and posts each message to the Dimension Labs universal API. The guide gives the steps, the field mapping and the code. The setup guide was checked against HubSpot's documentation on 2026-10-13.
What HubSpot data does Dimension Labs bring in?
This brings in the message threads from HubSpot's conversations inbox and help desk workspace (chat, email and other connected channels), one conversation per thread, with the associated ticket id so you can join to ticket data. You run it on your side: a small script pulls from the HubSpot Conversations API and posts each message to the universal API.
What do I need to connect HubSpot?
A HubSpot super admin, to create a private app. HubSpot requires super admin access for private apps. The private app's access token, with the conversations.read scope. A Dimension Labs API key for a new Universal API source.
How often does HubSpot data update?
Run the job once for history, then every 15 minutes. A live source is enriched automatically every day; history is enriched with a backfill.
Can I connect a platform that is not HubSpot?
Yes. Any platform with an API connects through the same universal API, and any tool with an export button works as a file upload. The integrations page lists the platforms with a written guide.
Stop reporting. Start understanding.
Start with one file. Ask why a number moved. Plans from $299 a month, no demo and no contract on monthly plans.