Integrating HubSpot
Capabilities
DataGrail's HubSpot integration provides the following capabilities:
Product | Capability | ||||
---|---|---|---|---|---|
Request Manager |
| ||||
Live Data Map | System Detection, Data Discovery |
Before You Start
To successfully configure this integration, please ensure you have sufficient privileges:
- DataGrail User Role: Super Admin, Connections Manager
- HubSpot User Role: Super Admin
Connect to DataGrail
- In DataGrail, select
v3
for the HubSpot API Version. - Select Login to Configure.
- Using a Super Admin account in HubSpot, select Grant access to give DataGrail permission to use the required scopes.
Required and Optional API Scopes
Required:
oauth
crm.objects.contacts.read
Depending on the integrations capabilities you've selected, additional scopes may be required:
Access:
content
(optional)crm.objects.deals.read
crm.lists.read
sales-email-read
(optional)
Deletion:
content
(optional)crm.objects.deals.read
crm.lists.read
sales-email-read
(optional)crm.objects.contacts.write
System Detection:
crm.schemas.contacts.read
crm.schemas.companies.read
(optional)tickets
(optional)e-commerce
(optional)
Responsible Data Discovery (RDD):
content
(optional)crm.objects.custom.read
(optional)sales-email-read
(optional)
Next Steps
Now that you've successfully connected the integration, check out the following resources:
Troubleshooting
If you are unable to successfully connect the integration, review these common troubleshooting steps:
Ensure Required Permissions Are Granted on API Keys/Resources
DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.
Review Required Account Types and User Roles
If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.
See Before You Start to review these requirements.
Technical Details
Access Type | Synchronous |
---|---|
Deletion Type | Synchronous |
Rate Limiting | - 50 requests / 10 seconds - 125,000 requests / day (DataGrail Limit) |
API Documentation
Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.
Disclaimer: The information contained in this message does not constitute as legal advice. We would advise seeking professional counsel before acting on or interpreting any material.