How to integrate HubSpot and Wistia

Last Updated: November 10, 2015

When you integrate your HubSpot and Wistia systems, and enable Wistia's Turnstile feature, your marketing and sales teams will be able to see which videos your visitor watch, as well as how much of each video they actually watched.

Customers wishing to integrate HubSpot and Wistia must be Wistia Enterprise users. While the Wistia integration is available to all HubSpot customers, the ability to segment lists based upon when a viewer starts watching a video and when a viewer watches 100% of the video, is only available to Enterprise accounts.

Using Wistia Turnstile for HubSpot form submissions

Using Wistia's Turnstile feature, you can prompt viewers to enter their email address before, during, or after they watch one of your videos. In order for HubSpot to be able to "know" which specific contact watched a video, you must use the Wistia Turnstile feature to capture the viewer's email address.

Using Wistia Turnstile for HubSpot form submissions

You can also use Wistia's Golden Ticket feature to make it so that if a viewer enters their email address once into a Turnstile form, they will not be prompted to enter their email address again on any other videos.

Instructions

Follow the steps below to integrate your HubSpot and Wistia accounts. Please note that in order for the integration to function as designed, the videos must not only be hosted in Wistia, but must be placed in actual website pages. 

1. Go to your Account Dashboard in Wistia

Log in to your Wistia account and click on the Settings link that appears when you hover over the Account menu item. (You'll need to log in as the account owner on your Wistia account in order to see the Account Dashboard option.)

1. Go to your Account Dashboard in Wistia

2. Enable the Wistia API for your account

Click on the Account Dashboard option on the right labeled API Access.

2. Enable the Wistia API for your account

Click on New Token. Name your token, select Read all data, then select Create Token.

3. Copy the API password to your clipboard

Copy the current API password to your clipboard, or to a plain text document. You'll need to paste it into your HubSpot in Step 7.

3. Copy the API password to your clipboard

4. Set up HubSpot as a provider in Wistia

Now click on Account > Settings, then choose the option on the right labeled Data Integrations.

4. Set up HubSpot as an email provider in Wistia

Under HubSpot, enter your Hub ID number into the input field and then click the Connect button.

Now you'll be asked to log in to your HubSpot account (if you're not already logged in) and then authorize Wistia Turnstile to use your data. Click the Authorize button to finish setting up HubSpot as an email provider.

Now you're free to prompt visitors to your site to provide an email address before watching one of your videos. Once they submit an email address, it will be registered as a form submission in your HubSpot Contacts database.

5. Navigate to your HubSpot Integrations home page

Log in to your HubSpot account. Click on your name (which appears in the upper right corner of the screen), then on the Integrations link to access your HubSpot account settings.

5. Navigate to your HubSpot Integrations home page

6. Select "Integrate with HubSpot" from the Wistia options

Find the Wistia integration and select Integrate with HubSpot.

6. Select "Integrate with HubSpot" from the Wistia options

7. Paste in your Wistia secret API password and enable the integration

Paste in the secret API password that you copied in Step 3 and then click the Connect! button.

7. Paste in your Wistia secret API password and enable the integration

You'll then see your secret password saved, and the button will now read Integration Enabled.

The integration is now enabled, but a few important steps remain to ensure that video heatmaps and events appear properly for your HubSpot contacts.

8. Copy the integration JavaScript

First, copy the JavaScript to your clipboard.

<script src='//fast.wistia.com/static/integrations-hubspot-v1.js"></script>

If you use the HubSpot COS

If your Wistia videos are on a HubSpot-hosted website page, go to Content Settings in your HubSpot account and paste this JavaScript into the Site Footer HTML area, then click on the Save Changes button.

If you use the HubSpot COS

If you use the HubSpot CMS

If you're using HubSpot's classic CMS, you'll need to go to Content Settings, then click on the Website Settings link under HubSpot Classic CMS Options.

If you use the HubSpot CMS

If the page with a video is not hosted in HubSpot

If you do not host the website pages with the Wistia video on HubSpot, you'll need to paste the code immediately after where you have pasted the normal HubSpot tracking code on those pages. Where exactly you paste this will vary depending on the custom configuration of your website.

For websites hosted on wordpress.org and using the HubSpot for WordPress plug-in, it is fine to have the Wistia integration JavaScript code inserted below, close to the HubSpot tracking code. It does not have to be inserted immediately after the HubSpot tracking code.

How to view which contacts have viewed your videos and how much of the videos they have viewed

When you have set up the Turnstile feature, and have integrated HubSpot and Wistia, each of your Turnstile submissions will appear inside your HubSpot as a form submission. The first time a Turnstile form is submitted, a form in HubSpot will be created based on the name of the video, and the submission will be passed through that form.

This means you can segment your contact database by which videos a contact has watched by creating a list based on contacts having filled out the form that has the name of your video:

segment by form submission

Segment contacts based on how much of the video they have watched (Enterprise only)

If you're using HubSpot Enterprise edition, the integration automatically creates custom events in the Events tool when viewers start watching a video, and when a viewer watches 100% of the video.

Segment contacts based on how much of the video they have watched (Enterprise only)

Wistia Heatmaps in the Contacts timeline

You'll also be able to view a Wistia heatmap for every video your contact watches, right inside that Contact's timeline.

Wistia Heatmaps in the Contacts timeline

Please note that submissions from filtered IP addresses in your Reports Settings will prevent the heatmap from showing up in a Contact's timeline.

You must include the integration code referenced in step 8 below on any website pages with Wistia videos embedded in order for custom Events and Wistia heatmaps to be created in HubSpot

Next Article: What does it mean to go live with HubSpot?

GET STARTED IN  YOUR HUBSPOT