Introduction
Raptor CDP integrates with HubSpot to enrich contacts with Audiences and Calculated Attribute infomation to do further selection in filters.
The HubSpot activation realtime updates HubSpot contacts when a person enters/leave an Audience or when an Calculate Attribute changes value in Raptor CDP.
How it works
In HubSpot a property group is created with the name: "Raptor Smart Advisor CDP". The group contains properties named after an Audience or a Calculated Attribute.
Below an example of an audience named "Abandon Basket" that is synced to HubSpot. When Contacts is part of audience "Abandon Basket" they will have value "true" in that property.
Setup
1. Create API Key in HubSpot
An API key is needed to sync data to HubSpot. Also known as an Access Token, this code will be created within the HubSpot interface itself.
Within your account, navigate to Private Apps under the CRM Development tab, and create a new Private App that will serve as your link to Raptor's systems. It is recommended that you give it an appropriate name and description.
In the next step, you will need to set the Scopes for the App - open the CRM section, and check the Read and Write boxes next to the lines crm.objects.contacts and crm.schemas.contacts.
Webhooks are not required for this, so once the Scopes have been set, you can simply click the Create app button at the top. Your finished app will appear in the Private Apps overview.
In the Info-view for this app, you will be able to find the Access Token under the Auth tab. Select Show Token to see it in full, then copy it for use in the creation of your new Activation.
The HubSpot Knowledge Base article on the topic may also be helpful!
2. Create Activation
2.a Fill in General infomation.
The identifier must be email.
2.b Fill in HubSpot information.
Use the API key/Access Token you found and copied earlier.
2.c Select Audiences or Calculated Attributes
Consider starting with just one - you can always add more later.
2.d Save the Activation
Now data from Raptor CDP is synced to HubSpot. This process may take some time depending on how many persons there are in an audience.
🔍Note: If you delete the linked Audience from Raptor's systems, the relevant Property will be deleted within HubSpot.
Troubleshooting
API Call Limits
HubSpot limits the total amount of hourly and daily requests we can make to their API on your behalf. Read more about these limits here.
HubSpot Plan: Free & Starter
- Maximum Number of API Calls per 10 Seconds, per Key or Token: 100
- Maximum Number of API Calls per Day, per Key or Token: 250,000
HubSpot Plan: Professional and Enterprise
- Maximum Number of API Calls per 10 Seconds, per Key or Token: 100
- Maximum Number of API Calls per Day, per Key or Token: 500,000
HubSpot Plan: API Add-On (Any Tier)
- Maximum Number of API Calls per 10 Seconds, per Key or Token: 120
- Maximum Number of API Calls per Day, per Key or Token: 1,000,000