diff --git a/docs/nodes/credentials/Hubspot/README.md b/docs/nodes/credentials/Hubspot/README.md index 73c57b36e..86dc8932b 100644 --- a/docs/nodes/credentials/Hubspot/README.md +++ b/docs/nodes/credentials/Hubspot/README.md @@ -2,20 +2,46 @@ permalink: /credentials/hubspot --- -# Hubspot +# HubSpot -You can find information about the operations supported by the Hubspot node on the [integrations](https://n8n.io/integrations/n8n-nodes-base.hubspot) page. You can also browse the source code of the node on [GitHub](https://github.com/n8n-io/n8n/tree/master/packages/nodes-base/nodes/Hubspot). +You can find information about the operations supported by the HubSpot node on the [integrations](https://n8n.io/integrations/n8n-nodes-base.hubspot) page. You can also browse the source code of the node on [GitHub](https://github.com/n8n-io/n8n/tree/master/packages/nodes-base/nodes/Hubspot). ## Prerequisites -Create a [Hubspot](https://www.hubspot.com/) account. +Create a [HubSpot](https://www.hubspot.com/) account. + +## Using OAuth + +1. Access your [HubSpot Developer Home](https://developers.hubspot.com/). +2. Click on 'Create an app'. +3. Specify an app name in the ***Public app name*** field. +4. Click on the 'Auth' tab. +5. Use the provided 'Client ID' and the 'Client secret' with your HubSpot OAuth2 API credentials in n8n. +6. Copy your OAuth Callback URL from the 'Create New Credentials' screen in n8n and paste in the ***Redirect URL*** section. +7. In the Scopes section, make sure that the 'Basic OAuth functionality' scope is selected from the ***Add a required scope*** dropdown list. +8. Select any other Scopes you plan to use with n8n. +9. Click on the ***Save*** button to save your settings in HubSpot. +10. Back in n8n, click on the circle button in the OAuth section to connect your HubSpot account to n8n. +11. Click the ***Save*** button to save your credentials. + +![Getting HubSpot OAuth credentials](./using-oauth.gif) ## Using Access Token -1. Access your Hubspot dashboard. +1. Access your HubSpot dashboard. 2. Click on the gear icon on the top. 3. Click on Integrations, API key. 4. Create Key. -5. Use the key with Hubspot node credentials in n8n. +5. Use the key with HubSpot node credentials in n8n. -![Getting Hubspot credentials](./using-access-token.gif) +![Getting HubSpot credentials](./using-access-token.gif) + + + +## Retrieving your Developer API Key (for HubSpot Trigger node) + +1. Access your [HubSpot Developer Home](https://developers.hubspot.com/). +2. Click on the ***Get HubSpot API key*** button. +3. Click on the ***Show key*** button. +4. Use the displayed Developer API key with your HubSpot Trigger node credentials in n8n. diff --git a/docs/nodes/credentials/Hubspot/using-oauth.gif b/docs/nodes/credentials/Hubspot/using-oauth.gif new file mode 100644 index 000000000..58439c4f9 Binary files /dev/null and b/docs/nodes/credentials/Hubspot/using-oauth.gif differ diff --git a/docs/nodes/nodes-library/trigger-nodes/HubSpotTrigger/README.md b/docs/nodes/nodes-library/trigger-nodes/HubSpotTrigger/README.md new file mode 100644 index 000000000..b61c441e2 --- /dev/null +++ b/docs/nodes/nodes-library/trigger-nodes/HubSpotTrigger/README.md @@ -0,0 +1,30 @@ +--- +permalink: /nodes/n8n-nodes-base.hubspotTrigger +--- + +# Hubspot Trigger + +[HubSpot](https://www.hubspot.com/) provides tools for social media marketing, content management, web analytics, landing pages, customer support, and search engine optimization. + +::: tip 🔑 Credentials +You can find authentication information for this node [here](../../../credentials/Hubspot/README.md). + +Note that for this node, you will have to retrieve the App ID and Client Secret using the OAuth instructions in addition to the Developer API Key. +::: + + +## Example Usage + +This workflow allows you to receive updates when a new contact is created in HubSpot. You can also find the [workflow](https://n8n.io/workflows/628) on the website. This example usage workflow would use the following node. +- [HubSpot Trigger]() + +The final workflow should look like the following image. + +![A workflow with the HubSpot Trigger node](./workflow.png) + + +### 1. HubSpot Trigger node + +1. First of all, you'll have to enter credentials for the HubSpot Trigger node. You can find out how to do that [here](../../../credentials/Hubspot/README.md). +2. Enter the HubSpot App ID in the ***App ID*** field. +3. Click on ***Execute Node*** to run the workflow. diff --git a/docs/nodes/nodes-library/trigger-nodes/HubSpotTrigger/workflow.png b/docs/nodes/nodes-library/trigger-nodes/HubSpotTrigger/workflow.png new file mode 100644 index 000000000..4c2019030 Binary files /dev/null and b/docs/nodes/nodes-library/trigger-nodes/HubSpotTrigger/workflow.png differ