How to: Configure a Hubspot Integration

Track referral sources, lead generation, conversation rates, and more with native integration options.

Brandlive’s Hubspot integration enables Admins to map and send Brandlive registration data to a Hubspot instance. With this integration, you can pass along any attendee data that is collected from your event registration form. Brandlive will filter out any unused fields created within your Brandlive integration instance to ensure previously collected data is not written over.

Preparing to Configure the Integration

Before configuring your integration, ensure that you have the proper permissions on Brandlive (Administrator) and Hubspot.

During the setup process you will be asked to provide the following authentication information:

  • Hubspot Prive App Token

Additionally, you will need to create a Private app within your Hubspot account containing only the following Scopes:

  • crm.objects.contacts.read
  • crm.onjects.contacts.write
  • crm.objects.companies.read
  • crm.objects.deals.read

Screenshot_2022-12-12_at_10.56.21_AM.png

You will also need to copy the field mappings from Hubspot into your Brandlive Integration configuration form in order to be able to pass registration data into Hubspot. Learn more about registration field mapping in Hubspot’s Help Center here. 

Configuring the Hubspot Integration

The Hubspot integration can be set up channel-wide (default setting) or for specific event groups.

To configure your integration, navigate to the gear icon in the bottom left corner of your Brandlive Admin dashboard. Then, select 'Integrations' from the menu:

integrations_1.png

From the Integrations page, select the '+ Add' button:

integrations_2.png

A new modal will appear. Select "Hubspot" from the list and click 'Next':

Screen_Shot_2022-11-29_at_4.36.07_PM.png

Next, a configuration form will appear. 

Screen_Shot_2022-11-29_at_4.37.19_PM.png

Complete each field using the guide below. 

  • Integration Name - A unique identifier for this integration within Brandlive. This name will be seen by all users in your channel with visibility of this integration.
  • API Endpoint - This multi-choice option indicates how you will be passing leads through to Hubspot. 'Create Contact' will create a new record if one does not exist and skip if it does not. 'Create or Update Contact' will create a new record if one does not exist and overwrite existing information if the record does exist.
  • Event Identification - This is an optional way to title your mapped fields when being passed through to Hubspot. This field is particularly useful if you want to collect registrations for multiple events without creating multiple integrations.   

  • Field Mapping - This two column section maps Brandlive registration questions through to the assigned Hubspot key. Select from event specific and global, channel level registration questions. Admin can add up to 50 rows.
  • UTM Parameters - Similar to the registration field section, this maps parameter keys or hidden fields passed through the Brandlive URL through to the assigned Hubspot key. Users can add up to 50 rows.

Once configured, fields can be edited or added to at any time. To save your configuration, click 'Next'.

Then, choose your associated Event Groups. If you do not have any Event Groups selected, the Brandlive integration panel will add the integration to all current and future events by default.

Screen_Shot_2022-11-29_at_4.20.21_PM.png

After selecting your event groups, click 'Next'.

A new page will open to authenticate the connection. Select "New Authentication". 

A modal will appear to complete two fields:

  • Hubspot Account name (Internal use only)
  • Hubspot Private Key Token

You will then be prompted to connect your Hubspot account within the pop-up authentication window.

Once you have created the authentication, click 'Finish' and navigate back to your Brandlive integrations panel. 

Toggle on your integration at the channel level to activate the integration for all selected Events/Groups:

Screen_Shot_2022-11-29_at_4.39.57_PM.png

Finally, toggle on your Integration at the event level in the "Event Details" screen to complete your Integration setup:

Screenshot_2022-12-12_at_11.00.14_AM.png

 

Editing or Deleting a Hubspot Integration 

To edit a Hubspot Integration, navigate to your integrations panel and click edit.

edit_integration.png

You can then update your fields or delete the integration.

Related Articles

Top