Last updated Oct 16th, 2024
Common Room's bidirectional integration with HubSpot CRM provides Common Room users with additional business context about the Contacts and Organizations in their instance and provides HubSpot users additional context about the Contacts and Companies they are engaging with.
See HubSpot fields, Contacts, Companies, Deals, and Activities alongside data in both Common Room and HubSpot.
HubSpot activities are not ingested into Common Room by default, this is available upon request only.
The HubSpot integration with Common Room is included on the Enterprise plan and is available as an add-on for Team and Startup plans. Additionally, you must be an admin of your HubSpot CRM instance (with the App Marketplace Access permission) in order to install the Common Room app in HubSpot.
In this step, you’ll configure how your Contacts, Companies, and Deals will map to Contacts and Organizations in Common Room. Additionally, you can configure how Contacts in Common Room are created from your Hubspot Contacts. You’ll be redirected here after completing the initial connection, but you can always come back to this step by opening Settings → Signals → HubSpot.
We recommend importing business context from your Contacts, Companies, and Deals that can be useful to know about a community Contact. We've filled in some recommended fields to help you get started, but you can add more fields as needed. Note that we also require a few fields in order to provide the best product experience.
Once you have defined your inbound update settings, it's important to understand that by default, only Common Room contacts that have a matching lead or contact (by email) in Hubspot will be updated with the Hubspot data. If you would like to create net new contacts in Common Room from your Hubspot contacts, use the Create settings to set this up.
Important: You will be setting up a filter criteria based on Hubspot fields. These fields must be mapped in the previous Update step in order to be available in the filter.
Important: If you do not specify any filter criteria and save your create settings, ALL of your Hubspot contacts will be created in Common Room. If you have more than 200k contacts, please contact us before proceeding.
Once you’ve setup the inbound data from HubSpot to Common Room, follow along below to configure how Common Room will update and/or create your contacts in HubSpot.
Once you’ve finished setting up your field mappings and are ready to test, save the field mapping then open the Contacts explorer page. Find a Contact you know exists in your HubSpot instance, and open their Contact profile. Press the Send to Hubspot button to sync this Contact to HubSpot, then view that contact in HubSpot to confirm that all fields are updated as expected.
There is currently no way to sync an individual organization to a Hubspot company. We recommend that you validate organizations using a test field before proceeding to enabling the auto-update. Contact us with any questions.
If everything looks good and you’re ready to set up your daily outbound sync, return back to the Outbound update settings page.
Enabling auto-update for contacts will update all contacts in Hubspot that have a matching primary email.
Enabling auto-update for companies will update all companies in Hubspot that have a matching root domain (e.g. http://www.commonroom.io and http://www.commonroom.io/home would both be considered a match).
Once you’ve finished setting up your field mappings and are ready to test, open the Contacts page and find a Contact you that doesn’t yet exist in HubSpot. Note that this Contact will need to have a primary email in order to be synced to HubSpot. Press the "Send to HubSpot" button to sync this Contact to HubSpot and confirm that the corresponding contact is created as expected.
If everything looks good and you’re interested in automatically creating contacts in your HubSpot, return back to the Outbound create settings page to configure your auto-create settings.
If everything looks good and you’re ready to set up your automatic sync, enable the auto-create toggle under Sync settings.
If you have any concerns about critical fields in HubSpot being overwritten with values from Common Room, the general best practice is to create Common Room specific fields in HubSpot so that we don't overwrite anything important. (For example: creating a "Common Room Full Name" field in HubSpot to map the Common Room name to).
When the integration is first configured, Common Room will sync field data for mapped fields (and optionally activities) for all HubSpot Contacts, Companies and Deals that have a corresponding match in your room.
This integration matches Common Room Contact fields from HubSpot for existing Contacts in Common Room, and won’t create any new Contacts in Common Room.
When the integration is first configured, Common Room will sync field and activity data for all HubSpot Contacts who have a corresponding Contact. Once the integration is configured, Common Room will import new activity from HubSpot every 8 hours. Common Room will sync data back to HubSpot on a daily basis.
HubSpot Contact fields are associated with existing Contacts in Common Room who have a corresponding Contact object in HubSpot. Contacts are matched between Common Room and HubSpot based on the email address associated. You may work with the Common Room team to define the specific Contact fields to import from HubSpot. We recommend importing into Common Room any business context that could be useful to know about a Contact. For example:
Contact owner | Marketing emails opened | |
---|---|---|
Lead status | Close date | Last marketing email open date |
Create date | Last contacted | Lifecycle stage |
HubSpot company fields are associated with organizations tied to Contacts in Common Room. You may work with the Common Room team to define the specific company fields to import from HubSpot. We recommend importing into Common Room any business context which could be useful to know about an organization. For example:
Company name | Lead status | Days to close |
---|---|---|
Company domain name | Create date | Close date |
Lifecycle stage | Company owner | Total revenue |
HubSpot deal fields are associated with deals tied to organizations withContacts in Common Room. You may work with the Common Room team to define the specific deal fields to import from HubSpot. We recommend importing into Common Room any business context which could be useful to know about an organization. For example:
Deal name | Create date | Annual contract value (ACV) |
---|---|---|
Deal stage | Close date | Monthly recurring revenue (MRR) |
Deal owner | Annual recurring revenue (ARR) |
The following HubSpot activities are available to pull into Common Room. Please contact us to enable this feature.
It's common to have Contacts who are potential leads and ready to engage with a Contact of your sales team, but who aren't yet created as a contact in your HubSpot.
Common Room can help you automatically identify community-qualified leads based on criteria specific to your business (e.g. Industry = Financial Services AND Annual revenue > $1M AND > 2 Slack posts in the last month AND mentioned “pricing”). You may work with the Common Room team to define your automated community qualification criteria.
After you review a Contact tagged as a community-qualified lead in Common Room, you can manually push the Contact to HubSpot via the "Send to HubSpot" button on the Contact profile to create a new Contact for your sales and marketing teams to review. When you create a new Contact in HubSpot via Common Room, Common Room populates the following HubSpot contact fields by default:
You may work with the Common Room team to define the additional community context you would like to sync to HubSpot as contact fields.
If you would like to set up an automated sync that creates new contacts in HubSpot from Common Room Contacts, contact us and we'll help you get set up.
For any Contacts already synced between HubSpot and Common Room, Common Room can automatically update their HubSpot contact fields to include relevant context.
We generally recommend creating new HubSpot fields for any context being sent back to HubSpot from Common Room to prevent overriding of existing data.
The following fields are available to sync into Hubspot for contacts:
city | emails | professionalEmail |
---|---|---|
commonRoomMemberLink | employmentRole | region |
communityEngaged | firstActivityDate | slackFirstSeenDate |
communityQualified | firstActivitySource | slackLinked |
communityQualifiedDate | firstName | slackUsernames |
companyName | fullName | slackLinked |
companyWebsite | githubUsernames | slackUsernames |
country | impactPointsAllTime | sources |
discordRoles | impactPoints12Weeks | title |
discordUsernames | impactPointsAllTime | twitterHandles |
discordVerificationDate | lastActivityDate | |
earliestMeetupGroupJoinDate | lastActivitySource | |
emails | lastName | |
employmentRole | linkedInUsernames | |
discordVerificationDate | meetupGroupMember | |
earliestMeetupGroupJoinDate | primaryEmail |
Lead scores can be synced with Salesforce by creating a new custom field for the score and then creating a mapping for this field to the appropriate Salesforce field.
For any organizations synced between HubSpot and Common Room, Common Room can automatically update their HubSpot company fields to include relevant context. This functionality is currently available only by request so please contact us if you would like to set this up.
We generally recommend creating new HubSpot fields for any context being sent back to HubSpot from Common Room to prevent overriding of existing data.
For tracking which contacts are created by Common Room in your Hubspot instance, map “Profile Url” in the “Outbound Create” mapping section. Then, filter within HubSpot for all contacts where the Profile Url field is not empty to find the records created by Common Room.
The following fields are available to sync into Hubspot for companies:
Capital Raised |
---|
Common Room Org Link |
Community Engaged |
Description |
Employee Count |
First Activity Date |
First Activity Signal |
First Seen Date |
First Seen Signal |
Impact Points 12 Weeks |
Impact Points All Time |
Last Activity Date |
Last Activity Signal |
Last Seen Date |
Last Seen Signal |
Number of Active Members 12 Weeks |
Number of Active Members All Time |
Number of Members |
Resolved Location City |
Resolved Location Country |
Resolved Location Country Region |
Revenue Range Max |
Revenue Range Min |
Sub Industry |
Technologies |
After you install the app, a Common Room widget will automatically appear on your HubSpot contact and company objects. These widgets are intended to provide HubSpot users with context about how Contacts and Companies have been engaging. Stronger engagement can indicate a higher likelihood to close.
The primary reason to set up an integration account is that, if you don’t, the HubSpot integration will break (and need to be reconnected) if/when the person who connected HubSpot leaves your company.
If you use Salesforce as your CRM and HubSpot as your MAP (Marketing Automation Platform), you may want to integrate both with Common Room to get a holistic view of your Contacts and organizations. This is possible today, but it’s important to keep a few important things in mind.
Here are some commonly mapped fields for contacts:
Here are some commonly mapped fields for companies:
Yes, you can! You can do this in one of three ways:
Depending on how your HubSpot outbound settings are configured, the resulting behavior in HubSpot will differ as follows:
Yes, you can! This feature is currently set up by request so please contact us if you're interested.
Before using this feature, there are a few important pre-requisites and caveats to note.
With these in mind, once you have the feature enabled, you can send a contact to a Hubspot sequence in one of three ways:
Depending on how your HubSpot outbound settings are configured, the resulting behavior in HubSpot will differ as follows:
Playbook
Playbook
Playbook
Playbook
Playbook
Playbook