Skip to content

HubSpot credentials#

You can use these credentials to authenticate the following nodes:

Supported authentication methods#

API key deprecated

HubSpot deprecated the regular API Key authentication method. The option still appears in n8n, but you should use the authentication methods listed above instead. If you have existing integrations using this API key method, refer to HubSpot's Migrate an API key integration to a private app guide and set up a service key.

UI based private apps are now legacy

HubSpot has moved private apps created in the UI to legacy status. If you're using a private app access token from this type of app, HubSpot recommends using a service key instead. Refer to HubSpot's Private Apps documentation for more information.

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 Service Key#

To configure this credential, you'll need a HubSpot account with super admin access or Developer tools access permission, and:

  • A Service Key

To generate a service key:

  1. In your HubSpot account, go to Development > Keys > Service Keys. (You can also find Service Keys under Settings > Account Management > Integrations > Service Keys.)

    The Service Keys page in HubSpot's Development menu

  2. Select Create service key.

    The Create Service Key form with name and scopes fields

  3. Enter a descriptive Name for your key.

  4. Select Add new scope and choose the permissions your integration needs. Refer to Required scopes for HubSpot node for a list of recommended scopes.
  5. Select Update to confirm your scope selections.
  6. Select Create, then confirm in the dialog.
  7. Click on the new service key name to navigate to its details page, and select Show to reveal your key.
  8. Copy the key value using the copy button, and paste it as the App Token in your n8n credential.

Service keys in public beta

Service keys are currently in public beta and subject to change. Refer to HubSpot's Service Keys documentation for the latest information.

Using Developer API key#

To configure this credential, you'll need a HubSpot developer account and:

  • A Client ID: Generated once you create a public app.
  • A Client Secret: Generated once you create a public app.
  • A Developer API Key: Generated from your Developer Apps dashboard.
  • An App ID: Generated once you create a public app.

To create the public app and set up the credential:

  1. Log into your HubSpot app developer account.
  2. Select Apps from the main navigation bar.
  3. Select Get HubSpot API key. You may need to select the option to Show key.
  4. Copy the key and enter it in n8n as the Developer API Key.
  5. Still on the HubSpot Apps page, select Create app.
  6. On the App Info tab, add an App name, Description, Logo, and any support contact info you want to provide. Anyone encountering the app would see these.
  7. Open the Auth tab.
  8. Copy the App ID and enter it in n8n.
  9. Copy the Client ID and enter it in n8n.
  10. Copy the Client Secret and enter it in n8n.
  11. In the Scopes section, select Add new scope.
  12. Add all the scopes listed in Required scopes for HubSpot Trigger node to your app.
  13. Select Update.
  14. Copy the n8n OAuth Redirect URL and enter it as the Redirect URL in your HubSpot app.
  15. Select Create app to finish creating the HubSpot app.

Refer to the HubSpot Public Apps documentation for more detailed instructions.

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:

Element Object Permission Scope name
n/a n/a n/a oauth
CRM Companies Read crm.objects.companies.read
CRM Companies schemas Read crm.schemas.companies.read
CRM Contacts Read crm.objects.contacts.read
CRM Contacts schemas Read crm.schemas.contacts.read
CRM Deals Read crm.objects.deals.read
CRM Deals schemas Read crm.schemas.deals.read

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're self-hosting n8n, you'll need to configure OAuth2 from scratch by creating a new public app:

  1. Log into your HubSpot app developer account.
  2. Select Apps from the main navigation bar.
  3. Select Create app.
  4. On the App Info tab, add an App name, Description, Logo, and any support contact info you want to provide. Anyone encountering the app would see these.
  5. Open the Auth tab.
  6. Copy the App ID and enter it in n8n.
  7. Copy the Client ID and enter it in n8n.
  8. Copy the Client Secret and enter it in n8n.
  9. In the Scopes section, select Add new scope.
  10. Add all the scopes listed in Required scopes for HubSpot node to your app.
  11. Select Update.
  12. Copy the n8n OAuth Redirect URL and enter it as the Redirect URL in your HubSpot app.
  13. Select Create app to finish creating the HubSpot app.

Refer to the HubSpot Public Apps documentation for more detailed instructions. If you need more detail on what's happening in the OAuth web flow, refer to the HubSpot Working with OAuth documentation.

Required scopes for HubSpot node#

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

Element Object Permission Scope name(s)
n/a n/a n/a oauth
n/a n/a n/a forms
n/a n/a n/a tickets
CRM Companies Read
Write		 crm.objects.companies.read
crm.objects.companies.write
CRM Companies schemas Read crm.schemas.companies.read
CRM Contacts schemas Read crm.schemas.contacts.read
CRM Contacts Read
Write		 crm.objects.contacts.read
crm.objects.contacts.write
CRM Deals Read
Write		 crm.objects.deals.read
crm.objects.deals.write
CRM Deals schemas Read crm.schemas.deals.read
CRM Owners Read crm.objects.owners.read
CRM Lists Write crm.lists.write
This page was