Hubspot Marketing

Overview
API Provider Setup
Authenticate
Events
Bulk APIs
Querying
Tips
API Docs

Tips

The Tips section includes more information about the element including FAQs, endpoint limitations, and general tips.

On this page
Authentication
Bulk
Webhooks

Authentication

  • Hubspot supports two different authentication mechanisms: API Key (Basic) and OAuth 2.0.0. When you authenticate an instance and include the HubSpot Portal ID, you use the latest OAuth 2.0 authentication.
  • If you intend to use the new OAuth 2.0, you must also provide scope. In Sandbox or developer accounts, HubSpot Marketing will never have appropriate scope to authenticate an instance. To authenticate an element instance with a HubsSpot Marketing trial account, you must create your own connected app with limited scope. See Scope below and Authenticate for more information about how to pass scope when you authenticate with Hubspot.

Scope

When users authenticate an element instance, they authorize your app to access the data allowed by the scopes that you pass to Hubspot. The user and their associated account must have access to all scopes that you pass. In addition to user permissions, Hubspot includes two types of scopes based on account level: Marketing only and Marketing and CRM.

Marketing Only Marketing and CRM
content contacts
reports timeline
social files
automation
forms
hubdb
For website add on
transactional-email
For Transactional-email add on

If you receive the following error message when authenticating, verify that the scopes you pass as part of authentication, the scopes selected in your registered app, user permissions, and account type scopes align. See Authenticate for more information about how to pass scope when you authenticate with Hubspot. HubSpot Scope

Review the Hubspot OAuth 2.0 scope documentation for the complete list of scopes.

Bulk

  • If you are trying to use Bulk upload to migrate data, you must provide the following metadata tag in the body, {"useBatchUpload": "true"}. If you do not provide this tag, it will upload one at a time.
  • If one batch fails, then all will fail.
  • HubSpot has a limitation where if too many properties exist the URL becomes too long for a request for all properties. Customers must map the properties they need to a common resource to leverage bulk for the object in question.

Webhooks