Introduction
Convertr has the ability to connect directly to Hubspot's API and create contacts within Hubspot using their Private Apps feature.
With our Hubspot Integration, we take advantage of the Create Contact API or the Create/Update Contact API to submit our lead data into Hubspot as a contact.
Please note, this integration does not submit data to a Hubspot form. For this, please see HTTP Integration Examples: Hubspot Forms.
Prerequisites
- Hubspot Access Token (you will need the correct permissions. Please see the Required Scope on the Hubspot documentation linked above)
- Hubspot REST API fields
Finding the Prerequisites in Hubspot
1. First you will need to obtain the Access Token. Within your Hubspot instance click the Settings icon in the top right hand corner.
2. In the left navigation bar scroll down to Account Setup > Integrations, then select Private Apps from the dropdown menu.
3. Click Create Private App.
4. Fill out the Basic Info section.
5. Select crm.objects.contacts with WRITE permissions when creating the scope, then click Create App.
6. Acknowledge you are creating a new Private App and click Continue Creating.
7. Click 'Go to app details' once your app has been created and an access token generated.
8. Within the app, click Show Token to reveal the full Access Token.
Setup in the Convertr Platform
1. Within your Convertr campaign, navigate to Processr > Integration. Click Add Job, and then select Hubspot Integration.
2. Copy the Access Token and paste it into the accessToken field in the API section.
3. Enter your write permissions. This can be either:
- Create: This will create a new contact in Hubspot. If the email address matches a lead that already exists in Hubspot, then the integration will fail.
- Create or Update: This will create a new contact, however if the email address matches a lead that already exists in Hubspot, then we will update that lead instead.
4. Next is the mapping section. Here you will map the Hubspot REST API names to the Convertr field names. Enter the Hubspot fields against the Convertr fields as shown below:
To add additional fields, select Add.
Please note: you do not need the first row, as this is just a guideline.
5. Once complete, select Save.
FAQs
Q: What does the Hubspot integration do?
A: After processing, Convertr sends valid leads into Hubspot (creating new Contacts).
Q: Do you support Hubspot Custom Objects?
A: At present we do not support Custom Objects.
Q: Are there any limits on API calls?
A: There is no rate limiting on our side. For every record we send there will be 2 calls to the Hubspot API (so you can easily check if you're within limits depending on lead volume and any rate limiting on Hubspot's side). Note that our own API does have rate limiting, which you can read more about here - but this does not apply to the Hubspot integration from our side.
Q: How does Convertr work with Hubspot workflows?
A: When a lead is delivered to Hubspot, you may want it to trigger a workflow - but this is entirely up to you (whether you do this and what you choose as the trigger event).
Q: How does Convertr with with Hubspot Email Sends, List Segmentation and Ad Management?
A: The Convertr Hubspot integration itself doesn't impact this directly. The impact on these items would be down to what you choose to do with the leads after they've been delivered to Hubspot.
Q: What timestamp format does Hubspot use?
A: Since 30/11/22 Hubspot only accepts unix timestamps for all Date and Datetime properties. To handle this, we recommend appending the milliseconds integration filter to your date fields, which will send data in the correct format without the need for Value Transforms. See Integration Filters for a full list of all integration filters.