Input Connector Nodes
      Back to home
      1. Home
      2. 5: Workflow Toolkit
      3. Input Connector Nodes

      HubSpot Connector

      Rayven.io allows seamless integration with HubSpot through predefined endpoints. With this integration, you can easily pull contact information, form submissions, and other data from your HubSpot account

      Rayven.io allows seamless integration with HubSpot through predefined endpoints. With this integration, you can easily pull contact information, form submissions, and other data from your HubSpot account to build custom workflows and visualizations in Rayven.

      This guide explains the steps required to connect HubSpot endpoints to Rayven.io and what options are available if the endpoint you need isn't pre-configured.



      Connect to HubSpot Endpoints in Rayven.io

      Here are the currently configured HubSpot endpoints in Rayven. Please note that they are configured but not tested, and you will need to provide valid HubSpot account details to complete the connection.

      1. Get All Contacts
        Endpoint: Get all contacts
        Description: Retrieve all contact records stored in your HubSpot CRM.
        Type: Input

      2. Get Recently Created Contacts
        Endpoint: Get recently created contacts
        Description: Retrieve contact records that were recently added to HubSpot.
        Type: Input

      3. Get Contacts in a List
        Endpoint: Get contacts in a list
        Description: Retrieve all contacts from a specific list in HubSpot.
        Type: Input

      4. Get Recently Added Contacts from a List
        Endpoint: Get recently added contacts from a list
        Description: Retrieve contacts that were recently added to a specific list.
        Type: Input

      5. Get Submissions for a Form
        Endpoint: Get submissions for a form
        Description: Retrieve all form submissions for a specific HubSpot form.
        Type: Input

      How to Connect HubSpot to Rayven.io

      1. Access the Rayven Workspace:

        • Navigate to the Workflows section in the Rayven Workspace.

      2. Create a Workflow:

        • Click Create a Workflow and give it a name that reflects its purpose.

      3. Add a HubSpot Input Node:

        • From the Input Nodes section, select the desired HubSpot endpoint.
        • Provide your HubSpot account details (API key or OAuth token) in the node configuration.

      4. Test the Connection:

        • Save the configuration and test the connection to ensure it retrieves the expected data from HubSpot.

      5. Incorporate Business Logic:

        • Add additional nodes to apply business logic, such as filters or triggers, to the incoming HubSpot data.

      6. Push Data to Dashboards or External Systems:

        • Use visualization nodes to display the HubSpot data in dashboards or output nodes to push data to other systems if needed.

      What If You Don’t Find the Endpoint You Need?

      If the available endpoints do not meet your specific requirements, you have two options:

      1. Use the HTTP Node:


        At Rayven.io, we understand that HubSpot’s API is extensive, and while we support many commonly used endpoints, there may be cases where you need a specific operation that isn't directly available in our built-in connectors. Don’t worry — Rayven.io’s HTTP Request node allows you to connect to any HubSpot API endpoint (or any other API) and fully customize your workflow.

        How the HTTP Request Node Works
        The HTTP Request node in Rayven.io enables you to make custom API calls to any REST API endpoint. You can specify the endpoint URL, request method (GET, POST, PUT, DELETE), headers, authentication type, query parameters, and body content.

        For HubSpot integrations, this means that if a specific action or operation isn’t available through our standard nodes, you can manually configure the HTTP Request node to perform the action by calling HubSpot’s API directly.


      2. Request a New Endpoint:

        • If you need a specific HubSpot endpoint added, contact our support team. We will configure the new endpoint for you within 72 hours.

      HubSpot Credentials

      You can use the following credentials to authenticate the HubSpot and HubSpot Trigger nodes in Rayven.

      Supported Authentication Methods

      • App Token: Use with the HubSpot node.
      • Developer API Key: Use with the HubSpot Trigger node.
      • OAuth2: Use with the HubSpot node.

      Note: The traditional API Key authentication method has been deprecated by HubSpot. While it may still appear in some platforms, it is recommended to use the authentication methods listed above. If you have existing integrations that utilize the API key method, please refer to HubSpot's guide on Migrating an API Key Integration to a Private App.

      Related Resources

      For further information, refer to HubSpot's API documentation. The HubSpot Trigger node uses the Webhooks API; refer to HubSpot's Webhooks API documentation for more details.

      Using App Token

      To configure this credential, you will need a HubSpot account or HubSpot developer account and the following:

      1. An App Token:
        • To generate an app token, create a private app in HubSpot:
          • In your HubSpot account, select the settings icon in the main navigation bar.
          • In the left sidebar menu, go to Integrations > Private Apps.
          • Select Create private app.
          • On the Basic Info tab, enter your app's Name.
          • Upload a square image as the logo for your app by hovering over the placeholder logo and selecting the upload icon.
          • Enter a Description for your app.
          • Open the Scopes tab and add the appropriate scopes. Refer to the Required scopes for HubSpot node for a complete list.
          • Select Create app to finish the process.
          • In the modal, review the information about your app's access token, then select Continue creating.
          • Once your app is created, open the Access token card and select Show token to reveal the token.
          • Copy this token and enter it in your Rayven credentials.
        • For more information, refer to the HubSpot Private Apps documentation.

      Using Developer API Key

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

      1. Client ID: Generated once you create a public app.
      2. Client Secret: Generated once you create a public app.
      3. Developer API Key: Generated from your Developer Apps dashboard.
      4. 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 your Rayven 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.
      7. Open the Auth tab.
      8. Copy the App ID and enter it in your Rayven.
      9. Copy the Client ID and enter it in your Rayven.
      10. Copy the Client Secret and enter it in your Rayven.
      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 Redirect URL provided in your Rayven and enter it as the Redirect URL in your HubSpot app.
      15. Select Create app to finish creating the HubSpot app.

      Using OAuth2

      Note for HubSpot Cloud Users

      Cloud users do not need to provide connection details. Simply select Connect my account to connect through your browser.

      If you're self-hosting Rayven, 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.
      5. Open the Auth tab.
      6. Copy the App ID and enter it in your Rayven.
      7. Copy the Client ID and enter it in your Rayven.
      8. Copy the Client Secret and enter it in your Rayven.
      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 Redirect URL provided in your Rayven and enter it as the Redirect URL in your HubSpot app.
      13. Select Create app to finish creating the HubSpot app.

      For more details on the OAuth web flow, refer to the HubSpot Working with OAuth documentation.



      Conclusion

      Integrating HubSpot with Rayven.io gives you the ability to leverage your CRM data in real-time workflows and dashboards. With several pre-configured endpoints available, you can quickly connect to key HubSpot resources like contacts, lists, and form submissions. If you require additional endpoints, you can easily set them up using the HTTP node or request new endpoints from our team.