Prerequisites
Before you begin, make sure you have:
An active Intercom account with admin access
An active HubSpot account with admin access
Login credentials for both platforms
Step 1: Create Your Interhubz Account
Click Sign Up
Enter your email and create a password
Verify your email address
Step 2: Connect Intercom
From your Interhubz dashboard, click Create Connection
Click Connect Intercom
Log in to your Intercom account when prompted
Review the requested permissions and click Authorize
You'll be redirected back to Interhubz
Step 3: Connect HubSpot
On the same connection setup page, click Connect HubSpot
Log in to your HubSpot account when prompted
Review the requested permissions and click Grant Access
You'll be redirected back to Interhubz
Give your connection a name (e.g., "Production Integration")
Step 4: Configure Conversation Capture
Now let's set up how conversations are synced:
Navigate to Connections → [Your Connection] → Conversations → Triggers
Select your preferred Capture Mode:
On Conversation Closed (Recommended): Syncs when conversations are marked closed in Intercom
Rolling Updates: Syncs at regular intervals
Manual Push Only: Sync via API only
Keep the default Noise Guards enabled to filter low-value conversations:
Minimum 2 customer messages
Minimum 1 minute duration
Require human participant
Click Save Settings
Step 5: Configure Destination
Choose where conversation notes appear in HubSpot:
Go to Conversations → Destination
Set When No Ticket Linked to Contact Timeline (recommended)
Set When Ticket Linked to Ticket Timeline (recommended)
Enable Contact Stubs if you want secondary reference notes
Click Save Settings
Step 6: Test Your Integration
Let's verify everything is working:
Open Intercom and start a test conversation
Add at least 2 messages from the customer side
Reply as an agent
Mark the conversation as Closed
Wait 1-2 minutes for processing
Open HubSpot and navigate to the contact's timeline
You should see a new note with the full conversation transcript
What Gets Synced?
Each synced conversation includes:
Summary: Conversation outcome and tags
Full Transcript: All messages with timestamps
Metadata: Conversation ID, state, timestamps, assignments
Attachments: List of any files shared
Next Steps
Now that your basic integration is working, explore these features:
Configure Matching
Go to Matching → Contact Matching to configure how contacts are matched
Set up email, phone, and external ID matching strategies
Set Up Ticket Sync
Go to Tickets → Stage Mapping to sync conversation states with ticket stages
Configure automatic ticket creation policies
Install the Inbox App
Install the Interhubz app in your Intercom Inbox
View HubSpot contacts and tickets directly in Intercom
Create and link tickets without leaving Intercom
Use the API
Enable API Push in Conversations → Triggers
Generate your API key
Trigger conversation capture programmatically
Common Issues
Conversation not syncing?
Check these settings:
Conversation has at least 2 customer messages
Conversation lasted at least 1 minute
Agent replied to the conversation (human participant)
Conversation was closed by an agent (not auto-closed)
Contact not matching?
Verify:
Contact has a valid email address in Intercom
Corresponding contact exists in HubSpot with same email
Email normalization settings in Matching → Contact Matching
Need to re-sync a conversation?
Use the API Push feature:
curl -X POST https://app.interhubz.com/api/v1/conversations/log \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"conversation_id": "123456789"}'
Questions? Contact our support team at team@interhubz.com