HubSpot credentials#

You can use these credentials to authenticate the following nodes:

Prerequisites#

Create a HubSpot account or HubSpot developer account.

Supported authentication methods#

App token: Used with HubSpot node
Developer API key: Used with HubSpot Trigger node
OAuth2: Used with HubSpot node

API key deprecated

HubSpot deprecated the API key authentication method. The option still appears in n8n, but you should use the other authentication methods.

Refer to HubSpot's API documentation for more information about the service. The HubSpot Trigger node uses the Webhooks API; refer to HubSpot's Webhooks API documentation for more information about that service.

Using App token#

To configure this credential, you'll need:

An APP Token: To generate an app token, create a private app in HubSpot. Refer to the HubSpot Private Apps documentation for detailed instructions.

Authenticating the credential can fail if you don't use appropriate scopes. See Required scopes for HubSpot node for required scopes for this app.

Using Developer API key#

To configure this credential, you'll need:

A Client ID: Generated once you create a public app, displayed in the app's Auth settings. Refer to the instructions in the HubSpot Public Apps documentation.
- Use the n8n OAuth Redirect URL as the Redirect URL in your HubSpot app.
A Client Secret: Generated once you create a public app, displayed in the app's Auth settings.
A Developer API Key: Generated from your Developer Applications dashboard. Refer to HubSpot Developer API keys for more information.
An App ID: Generated once you create a public app, displayed in the app's Auth settings.

Authenticating the credential can fail if you don't use appropriate scopes. See Required scopes for HubSpot Trigger node for required scopes for this app.

Required scopes for HubSpot Trigger node#

If you're creating an app for use with the HubSpot Trigger node, n8n recommends starting with these scopes:

oauth
crm.objects.companies.read
crm.objects.contacts.read
crm.objects.deals.read
crm.schemas.companies.read
crm.schemas.contacts.read
crm.schemas.deals.read

HubSpot old accounts

Some HubSpot accounts don't have access to all the scopes. HubSpot is migrating accounts gradually. If you can't find all the scopes in your current HubSpot developer account, try creating a fresh developer account.

Using OAuth2#

Note for n8n Cloud users

Cloud users don't need to provide connection details. Select Connect my account to connect through your browser.

If you need to configure OAuth2 from scratch, you'll need to create a public app. Refer to the instructions in the HubSpot Public Apps documentation. If you need more detail on what's happening in the OAuth web flow, refer to the HubSpot Working with OAuth documentation.