Connect HubSpot to MasterInbox, authorize the correct account, select the channels to sync, and configure contact properties, field mappings, and CRM behavior for selected labels.
1. Open HubSpot Integration
In MasterInbox, navigate to Settings → Integrations → HubSpot
2. Choose Connection Type
You will see two options:
Create a new HubSpot account
Sign in to your existing HubSpot account
Select the option that applies to you.
3. Select Your HubSpot Account
After choosing Sign in to your HubSpot account, you will be redirected to HubSpot to authenticate.
Once you sign in, you will see a screen to select an account.
You may see one or more HubSpot accounts listed (for example: Marsha and Books).
Select the correct account you want to connect with MasterInbox.
Then click Choose Account to continue.
HubSpot Sync Settings Screen
After successful connection, you’ll be redirected to the HubSpot Sync Settings inside MasterInbox.
This is where you control how Master Inbox and HubSpot sync, including what data is shared, how contacts are handled, and how updates flow between both systems.
Channel Selection
Choose which channels should be associated with HubSpot syncing.
For example:
Gmail
Linkedin
You can select:
All channels or
Specific channels depending on your workflow
This determines what activity gets reflected back into HubSpot contact records.
Contact Properties
Choose which HubSpot contact properties should sync with MasterInbox.
You can select the specific contact properties you want to use during synchronization, allowing you to control exactly what information is shared between both platforms.
Only the selected contact properties will be available for field mapping later in the setup.
What this is used for:
This mode is mainly for teams who want to:
Validate contact matching
Avoid accidental CRM updates
Test integration before going live
Default Meeting Link
If your HubSpot account has meeting links configured, you can choose a Default Meeting Link from the dropdown.
This meeting link is used by Reply Agents when suggesting available meeting times and booking meetings with prospects.
Choose the meeting link that should be used by default for this integration.
Sync Options
You can configure how MasterInbox syncs conversations and contacts with HubSpot using the following options.
Auto-Save Conversation on Reply
When enabled, MasterInbox automatically saves email conversations to HubSpot whenever a prospect replies.
This keeps your CRM up to date without requiring manual logging.
Do not create contacts in HubSpot
When enabled, MasterInbox updates existing HubSpot contacts only; it does not create new contacts. Existing contact matching and supported updates may still occur. This is not a read-only or no-data-sent mode.
Labels → CRM Behavior Mapping
Map MasterInbox labels to HubSpot actions/deal stages.
Choose a label from your workspace and select the corresponding HubSpot action or deal stage that should be triggered when the label is applied.
For example:
Meeting Booked → Appointment Scheduled
Qualified → Qualified Lead
Payment Due → Payment Pending
This helps keep your HubSpot pipeline automatically updated based on conversation activity inside MasterInbox.
Field Mapping
Field Mapping lets you synchronize data between MasterInbox and HubSpot.
Auto-Sync Fields
Available options include:
Auto-sync Fields: MasterInbox → HubSpot
Auto-sync Fields: HubSpot → MasterInbox
Enable one or both options depending on the direction you want your data to sync.
MasterInbox Field Mapping
Choose which MasterInbox fields should map to your HubSpot contact properties.
Only the HubSpot contact properties selected earlier in the setup will be available for mapping.
This allows you to keep prospect information consistent across both platforms.
Static Value Mapping
You can also assign fixed values to HubSpot contact properties.
Click Add Mapping, enter the value you want to send, and select the HubSpot property that should always receive that value during synchronization.
This is useful for automatically assigning values such as lead source, campaign type, or internal classifications.
Available MasterInbox mapping fields
When creating field mappings, you can choose from the following MasterInbox fields:
Campaign ID
Company
Custom Case Study Link
Custom Company Domain
Custom Company LinkedIn
Custom Country
Custom Full Name
Custom ICP
Custom LinkedIn URL
Custom Location
Custom State
Custom Timeline
Deal Status
Deal Value
Domain
Email
First Name
HubSpot ID
Job Title
Last Name
LinkedIn
Name
Website
Map these fields to the corresponding HubSpot contact properties to keep your contact information synchronized across both platforms.
Sync Only Selected Lead Labels
To sync selected types of leads, such as positive replies, open Settings → Integrations → HubSpot and configure the Labels → CRM Behavior Mapping section.
Choose the MasterInbox label you want to sync, such as Positive or Interested.
Map the label to the appropriate HubSpot Lead Status or Lifecycle Stage.
Make sure the relevant channels are selected.
Save the integration settings.
When a prospect receives a mapped label, MasterInbox syncs the contact and its conversation to HubSpot with the configured properties. The label mapping does not automatically backfill earlier leads. To push an existing prospect, open its details and use Add to HubSpot.
Overwrite Existing HubSpot Values
In Field Mapping, use the Overwrite setting to control what happens when HubSpot already contains a value.
On: MasterInbox replaces the existing HubSpot value with the mapped MasterInbox value.
Off: MasterInbox fills the HubSpot property only when that property is empty.
The Overwrite switch becomes available when you select a HubSpot field for the mapping. It is enabled by default for configured mappings. Review this setting before syncing fields that your team also edits directly in HubSpot.
Unsaved Changes
If you leave the HubSpot settings page without saving, MasterInbox warns that your changes have not been saved. Choose Save changes to keep the configuration or Cancel to remain on the page. Refreshing or closing the browser tab uses the browser warning.
Contact Matching and Sync Triggers
MasterInbox first uses a previously linked HubSpot contact, then an exact email match, and then a LinkedIn profile match when the prospect has no email. Without an email or LinkedIn profile, matching cannot proceed.
Sync can be triggered by a mapped label, an eligible reply when Auto Save Conversation On Reply is enabled, a manual Sync to HubSpot action, or a workflow action. The selected channels and contact-creation settings still apply.
Conversation Activity in HubSpot
Synced email conversations are logged as email activities with their direction, sender, recipients, subject, and body. LinkedIn and HeyReach messages are recorded as LinkedIn activities where supported or as notes. An optional setting also logs each new synced message as a note; this creates an additional activity and does not retroactively backfill older messages.
HubSpot Records and Meetings
The HubSpot contact record can display a MasterInbox panel for reading recent conversations and replying through the original MasterInbox channel. Replies are queued for sending; the panel cannot start a new email thread without an existing message.
HubSpot meeting links can be selected for reply-agent booking and for display on the MasterInbox Bookings page. Keep at least one link selected if you want calendar synchronization to remain enabled.
Important Sync Behaviors
Each field mapping has an Overwrite option. When off, existing HubSpot values are preserved while empty values can still be filled.
HubSpot lifecycle stages generally move forward; a backward stage change may be rejected while other contact updates continue.
Mapping multiple labels to conflicting changes can produce unpredictable outcomes. Avoid contradictory rules.
Workflow-triggered Sync to HubSpot applies configured field mappings and activity sync, but label-driven lead-status, lifecycle-stage, and deal rules require the corresponding label event.
Removing the HubSpot integration from MasterInbox may clear integration settings; review your configuration before disconnecting.
Save Configuration
Once everything is configured, click: Save
HubSpot Tab in Prospect Details
You can manage HubSpot directly from any prospect inside your inbox.
How to access it:
Go to your Inbox
Open any prospect
Click the three dots (⋯) - Prospect Details
Go to the HubSpot tab
Click Add to HubSpot
What happens when you do this:
The prospect is created or linked in HubSpot
Contact data is synced based on your integration settings
You can then manage and update the contact directly from MasterInbox
Your HubSpot integration will now be fully active and syncing based on your selected configuration.
Do outgoing messages sync even if a prospect has not replied?
A send alone does not start an automatic reply-driven sync. When a matching label changes, a reply triggers a configured sync, or you manually sync the prospect, the sync can log earlier outgoing messages that were not already logged in HubSpot.
Can I manually sync a prospect that already has a mapped label?
Yes. Manual Sync to HubSpot reads the prospect's current labels and applies matching configured mappings. You do not need to remove and reapply the label simply to initiate a manual sync.
Does the logged-in HubSpot user need deal access?
Yes, if your integration needs to access deals. If deal access is missing, reconnect with an authorized HubSpot user and grant the required deal permissions.