If your organization uses both Virtuous CRM+ and HubSpot, the integration between the two platforms will allow you to keep consistent data across both. This documentation covers the 2.0 integration of Virtuous CRM+ and HubSpot, which allows Contacts AND Individuals in Virtuous CRM+ to sync between and/or update to contacts in HubSpot.
Table of Contents
- Sync Details
- Create New User
- Set Up Integration
- Credentials
-
Features and Mapping
- Standard
- Email List
- Contact Statistics
- Tags
- Initial Sync
- Virtuous CRM+ Individuals to Hubspot Contacts
- Email and Communication Subscriptions
- Bundles and Real Time
1. Sync Details
This sync occurs bidirectionally and details of this are covered below.
- The HubSpot to Virtuous CRM+ sync is a "Batch Integration", meaning the incoming data will be available for review in the Gift and Contact Import Tool.
- The Virtuous CRM+ to HubSpot sync is a "real-time" sync that relies on webhooks.
- HubSpot contacts will all be synced to Virtuous CRM+. Virtuous CRM+ Contacts can be synced in full or a as subset to HubSpot.
-
There is ability to select an integration that functions as the 1.0 (one way sync to Virtuous CRM+) or the 2.0 integration functions (two way or one way to HubSpot).
- The two-way option available in the 2.0 integration will allow for Email Marketing activity to sync from HubSpot to Virtuous CRM+. Email Marketing activity will not push from Virtuous CRM+ to HubSpot.
2. Create New Users
First, you'll want to create a new user account for the integration. We recommend creating a new user account in Hubspot and in Virtuous CRM+ that will be dedicated just for the integration. You can follow the instructions in this article to add a new user to Virtuous CRM+. This user should be a user account that will not be used by anyone, and is solely for the purposes of facilitating integration between Hubspot and Virtuous CRM+. The user account should have Admin permissions. Create the same user in Hubspot as well.
3. Set Up the Integration
Now, you've got everything you need! It's time to actually configure the sync.
To setup, review, or manage the details of this integration, select "Integrations" from the left-hand menu. Select "Virtuous Connect" from the available options.
Note: It's recommended to sync with your organization's DBA regarding any modifications needed or errors occurring.
There, you can log in using the using the same Virtuous CRM+ credentials you created earlier for your integration.
If your team may need additional support implementing and/or managing the HubSpot integration, check out the Virtuous App Marketplace.
To access the App Marketplace, select "App Marketplace" from the Integrations menu.
Note: Only Admin Users can access the App Marketplace within Virtuous CRM+.
To learn more about the Virtuous App Marketplace, check out this Support Article.
From the available options, select "View" in the HubSpot window.
In the pop-out window, complete the necessary fields.
From there, you'll select Hubspot, go to integration settings then follow the steps below:
1. Sync Enabled
- To enable this integration, check this box
- Default value TRUE
2. Sync to Hubspot
- To sync Virtuous CRM+ Contacts/Individuals to Hubspot Contacts
- Default value TRUE
3. Sync to Virtuous CRM+
- To sync HubSpot Contacts to Virtuous CRM+ Contacts/Individuals
- Default value TRUE
4. Sync Email Activity
- To sync email activity with the contacts, check this box
- Default value TRUE
5. Sync Form Submissions
- To sync form submission with the Contacts, check this box
- Default value TRUE
6. Sync Tags
- Tags that you sync over using step 9 will have all those Contacts associated to a List in HubSpot.
- If a Contact List in Hubspot does not yet exist with a matching Tag name, the integration will create the list. However, we strongly recommend to manually create the Contact List in HubSpot with a matching Tag name prior to adding the Tags to any Virtuous CRM+ Contacts.
- Changes to the Tag and List (respective in each system) will need to be updated manually in the other system.
7. Do Not Overwrite Name
- In the event that the Individuals on a Contact share the same Email, the existing contacts in HubSpot will not have their name overwritten by any of the other individuals on the record.
- If the contact is being created new it will take and maintain on the primary individual's name on the HubSpot record.
8. Virtuous CRM+ Contact ID Mapping
- This needs to be mapped to a Custom Object/Field in HubSpot's Contact Property that is a text field.
9. Tags
- (2) needs to be checked if this function is to be used
- Utilized as filter to determine which contacts are to be synced FROM Virtuous CRM+ to HubSpot
- Leaving this field blank will Sync ALL of Virtuous CRM+ Contact Individuals to HubSpot as contacts
10. Email List Mapping
- 10a-Email Lists (Virtuous CRM+)
- Users in this email list will be added to the subscription in HubSpot
- Selecting this field will Sync the email's opt in/out with the item selected in
- 10b- HubSpot Subscription (HubSpot)
- Users in this subscription will be added to the email list in Virtuous CRM+
- Selecting this field will Sync the email's opt in/out with the item selected in
11. Contact Statistics Mapping
- 11a- Contact Statistics (Virtuous CRM+)
- All available Statistic fields in Virtuous CRM+
- Select the fields you would want to be brought over to HubSpot
- 11b- HubSpot Contact Properties (HubSpot)
- Custom fields in HubSpot to receive Statistic data
- Select the field you would want the Virtuous CRM+ data (6a) to be stored in HubSpot
4. Credentials
1. From the Integration Credential Page, click "Connect"
2. You should be brought to your HubSpot login. This is where you'll login with the account you created at the beginning of the article.
3. Select "Connect App"
You should then be brought back to the Virtuous CRM+ page with a confirmation below:
5. Features and Mapping
Standard Field Mapping
Email List Mapping
Virtuous CRM+ Email Lists can be mapped to HubSpot Communication SubscriptionsThis can be completed in "How to set it up" 5a and 5b
Contact Statistics Mapping
- Virtuous CRM+ Contact Statistic fields can be mapped to any HubSpot Contact Property fields.
- When selecting a HubSpot Contact Property Field to be populated, any existing data will be overwritten by Virtuous' incoming data
- This can be completed in "How to set it up" 6a and 6b
Available Statistic Fields
6. Tags
This field is populated from Virtuous CRM+ Tags. When the Tag field is selected it will add the tag to the contact record in HubSpot and Virtuous CRM+.
7. Initial Sync
Upon setting up the integration, the initial sync between Virtuous CRM+ and HubSpot will match HubSpot email addresses against Virtuous CRM+ individual email addresses. No contacts will sync, but HubSpot Contact Ids will populate the ReferenceId at the individual level.
Once this is completed, webhooks from Virtuous CRM+ to HubSpot will be invoked. HubSpot names will update to what is stored in Virtuous CRM+ (this maintains Virtuous CRM+ as the single source of truth).
8. Virtuous CRM+ Individuals to HubSpot Contacts
When a Contact record in Virtuous CRM+ contains multiple Individuals these individuals will have their own individuals Contact record in HubSpot
9. Email and Communication Subscription
HubSpot Re-Subscribe
Virtuous CRM+ Re-Subscribe
10. Bundles and Real-Time
HubSpot to Virtuous CRM+
- Every 3 hours data will be pulled from HubSpot, new contacts will be added to a Contact Import Bundle in Virtuous CRM+. These contacts will be available for import into Virtuous CRM+ via the Contact Import Tool. (Access via Contacts-->Import Contacts)
-
Sync Log is available in Virtuous CRM+ Integrations view, this will show what has Synced in both directions
Virtuous CRM+ to HubSpot
- When a new or update to a contact is made in Virtuous CRM+, that meets the criteria (Tag field in setup), a webhook request is made to connect both Apps and the update/creation is placed into a queue. These requests are made nearly in real-time.
- Updates need to be made to the Contact/Individual Record in the Edit Modal or Import Tool to invoke the webhook
- A change to the Statistics would not invoke the webhook to update the HubSpot contact
- Once a contact is synced from HubSpot to Virtuous CRM+, Virtuous CRM+ will utilize the ReferenceId (at the Individual level) to connect and update any changes to an Individual (in Virtuous CRM+) to the Contact record (in HubSpot).
Limitations
- Virtuous CRM+ Custom Fields cannot map to a HubSpot field in this Integration
- Some HubSpot Custom Fields cannot map to a Virtuous CRM+ field in this Integration