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. Set up the scopes appropriately, then finalize the creation of this app.

In the Info-view for the app, you will now be able to view the Access Token. 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

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.

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