How Does Virtuous Integrate with HubSpot? – Virtuous

This documentation covers the 2.0 integration of Virtuous and HubSpot. The integration allows contacts AND individuals in Virtuous to sync between and/or update to contacts in HubSpot.

This sync occurs bidirectionally and details of this are covered below. The HubSpot to Virtuous sync is a "Batch Integration". The Virtuous to HubSpot sync is a "real-time" sync that relies on webhooks.

HubSpot contacts will all be synced to Virtuous. Virtuous contacts can be synced as a whole or a subset to HubSpot.

There is ability to select an integration that functions as the 1.0 (one way sync to Virtuous) or the 2.0 integration functions (two way or one way to HubSpot).

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 that will be dedicated just for the integration. You can follow the instructions in this article to add a new user to Virtuous. 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. The user account should have Admin permissions. Create the same user in Hubspot as well.

Setting up the integration

Head over to http://connect.virtuoussoftware.com/ and log in. 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 Contacts/Individuals to HubSpot Contacts
Default value TRUE

3. Sync to Virtuous

To sync HubSpot Contacts to Virtuous 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. Tags

Needs to be checked if this function is to be used
Utilized as filter to determine which contacts are to be synced FROM Virtuous to HubSpot
Leaving this field blank will Sync ALL of Virtuous Contact Individuals to HubSpot as contacts

7. Email List Mapping

7A- Email Lists (Virtuous)
- Users in this email list will be added to the subscription in HubSpot (5b)
- Selecting this field will Sync the email's opt in/out with the item selected in 5b
7B- HubSpot Subscription (HubSpot)
- Users in this subscription will be added to the email list in Virtuous (5a)
- Selecting this field will Sync the email's opt in/out with the item selected in 5a

8. Contact Statistics Mapping

8A- Contact Statistics (Virtuous)
- All available Statistic fields in Virtuous
- Select the fields you would want to be brought over to HubSpot
8B- HubSpot Contact Properties (HubSpot)
- Custom fields in HubSpot to receive Statistic data
- Select the field you would want the Virtuous data (6a) to be stored in HubSpot

Credentials

From the Integration Credential page, click "Connect"
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.
Select "Connect app"

4. You should be brought back to the Virtuous page with a confirmation below:

Features and Mapping

Standard Field Mapping

Email List Mapping

Virtuous Email Lists can be mapped to HubSpot Communication Subscriptions

This can be completed in "How to set it up" 5a and 5b

Contact Statistics Mapping

Virtuous 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

Initial Sync

Upon setting up the integration, the initial sync between Virtuous and HubSpot will match HubSpot email addresses against Virtuous 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 to HubSpot will be invoked. HubSpot names will update to what is stored in Virtuous (this maintains Virtuous as the single source of truth).

Virtuous Individuals to HubSpot Contacts

When a Contact record in Virtuous contains multiple Individuals these individuals will have their own individuals Contact record in HubSpot

Email Subscription and Communication Subscription

HubSpot Re-subscribe

Virtuous Re-subscribe

Bundles and Real-Time

HubSpot to Virtuous

Every 3 hours data will be pulled from HubSpot, new contacts will be added to a Contact Import Bundle in Virtuous. These contacts will be available for import into Virtuous via the Contact Import Tool. (Access via Contacts-->Import Contacts)

Sync Log is available in Virtuous Integrations view, this will show what has Synced in both directions

Virtuous to HubSpot

When a new or update to a contact is made in Virtuous, 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 webook
A change to the Statistics would not invoke the webhook to update the HubSpot contact
Once a contact is synced from HubSpot to Virtuous, Virtuous will utilize the ReferenceId (at the Individual level) to connect and update any changes to an Individual (in Virtuous) to the Contact record (in HubSpot).

Limitations

Virtuous Custom Fields cannot map to a HubSpot field in this Integration
HubSpot Custom Fields cannot map to a Virtuous field in this Integration

In this article: