> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/integrations/builtin/credentials/hubspot.md).
# HubSpot credentials
You can use these credentials to authenticate the following nodes:
* [HubSpot](/integrations/builtin/app-nodes/n8n-nodes-base.hubspot.md)
* [HubSpot Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.hubspottrigger.md)
## Supported authentication methods
* Service key (recommended): Use with the [HubSpot](/integrations/builtin/app-nodes/n8n-nodes-base.hubspot.md) node.
* Developer API key: Use with the [HubSpot Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.hubspottrigger.md) node.
* OAuth2: Use with the [HubSpot](/integrations/builtin/app-nodes/n8n-nodes-base.hubspot.md) node.
{% hint style="warning" %}
**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](https://web.archive.org/web/20240106022147/https://developers.hubspot.com/docs/api/migrate-an-api-key-integration-to-a-private-app) guide and set up a service key.
{% endhint %}
{% hint style="warning" %}
**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](https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview) for more information.
{% endhint %}
## Related resources
Refer to [HubSpot's API documentation](https://developers.hubspot.com/docs/api/overview) for more information about the service. The [HubSpot Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.hubspottrigger.md) node uses the Webhooks API; refer to [HubSpot's Webhooks API documentation](https://developers.hubspot.com/docs/api-reference/webhooks-webhooks-v3/guide) for more information about that service.
## Using Service Key
To configure this credential, you'll need a [HubSpot](https://www.hubspot.com/) 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**.)
2. Select **Create service key**.
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](#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.
{% hint style="info" %}
**Service keys in public beta**
Service keys are currently in public beta and subject to change. Refer to [HubSpot's Service Keys documentation](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/account-service-keys) for the latest information.
{% endhint %}
## Using Developer API key
To configure this credential, you'll need a [HubSpot developer](https://developers.hubspot.com/) 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](https://developers.hubspot.com/).
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](#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](https://developers.hubspot.com/docs/apps/legacy-apps/public-apps/overview) for more detailed instructions.
### Required scopes for HubSpot Trigger node
If you're creating an app for use with the [HubSpot Trigger](/integrations/builtin/trigger-nodes/n8n-nodes-base.hubspottrigger.md) 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
{% hint style="info" %}
**Note for n8n Cloud users**
Cloud users don't need to provide connection details. Select **Connect my account** to connect through your browser.
{% endhint %}
If you're [self-hosting](/deploy/host-n8n.md) n8n, you'll need to configure OAuth2 from scratch by creating a new public app:
1. Log into your [HubSpot app developer account](https://developers.hubspot.com/).
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](#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](https://developers.hubspot.com/docs/apps/legacy-apps/public-apps/overview) 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](https://developers.hubspot.com/docs/apps/legacy-apps/authentication/working-with-oauth).
## Required scopes for HubSpot node
If you're creating an app for use with the [HubSpot](/integrations/builtin/app-nodes/n8n-nodes-base.hubspot.md) 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` |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.n8n.io/integrations/builtin/credentials/hubspot.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.