View a markdown version of this page

HubSpot integration - Amazon Quick
PrerequisitesVerifying your HubSpot accountConfiguring your HubSpot accountSetting up the integration in Amazon QuickUsing available actionsTroubleshooting
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

HubSpot integration

Access your HubSpot CRM data directly from Amazon Quick using natural language. With the HubSpot action connector, you can retrieve and list contacts, companies, deals, and tickets without leaving Amazon Quick.

HubSpot is available as a built-in connector in Amazon Quick. To set up this integration, complete the following two steps. First, prepare your HubSpot account with the required access. Then, create the connector in Amazon Quick and authenticate with your HubSpot credentials.

This connector supports Custom OAuth app authentication. For information about the authentication methods that Amazon Quick supports, see Authentication methods.

Prerequisites

Before you set up the integration, verify that you have the following resources and access.

  • An active HubSpot account with an admin role.

  • Permissions to access CRM data including contacts, companies, deals, and tickets in your HubSpot account.

  • A subscription that meets the requirements described in Set up integrations in the console.

Verifying your HubSpot account

Before you configure Amazon Quick, verify that your HubSpot account meets the following requirements.

  • Your HubSpot account is active and you can sign in to the HubSpot sign-in page on the HubSpot website.

  • The CRM data that you want to access, including contacts, companies, deals, and tickets, is accessible to your account.

Configuring your HubSpot account

The Custom OAuth app authentication method in Amazon Quick requires a MCP Auth app configured in your HubSpot developer settings.

To configure a MCP Auth App

  1. Sign in to your HubSpot account.

  2. Navigate to Development, and then MCP Auth Apps.

  3. Choose Create MCP auth app.

  4. On the Create MCP Auth App window, complete the following fields:

    • Name – Enter a name for your app.

    • Description – Enter a short description.

    • Redirect URL – Enter https://region.quicksight.aws.amazon.com/sn/oauthcallback. Replace region with your Amazon Region, for example, us-east-1.

  5. Choose Create. HubSpot creates the app and generates a client ID and client secret.

    Important

    Record the client secret and client ID.

The client ID and client secret serve as the Client ID and Client Secret when you configure the action connector in Amazon Quick with the Custom OAuth app authentication method.

For more information, see HubSpot MCP server on the HubSpot website.

Setting up the integration in Amazon Quick

After you verify your HubSpot account access, create the connector in Amazon Quick.

  1. In the Amazon Quick console, choose Connectors.

  2. Choose the Create for your team tab.

  3. Choose HubSpot from the options available.

  4. In the HubSpot dialog, enter the following fields:

    • Name – A descriptive name for your HubSpot connector.

    • Description (Optional) – Choose + Add Description to add notes about how this connector will be used.

    • Connection type – Choose Public network.

  5. For the Custom OAuth app authentication method, enter the following fields:

    • Base URL – This field is auto-populated as https://mcp.hubspot.com.

    • Client ID – Enter the client ID from your HubSpot MCP Auth app.

    • Client Secret – Enter the client secret from your HubSpot MCP Auth app.

    • Token URL – This field is auto-populated as https://api.hubapi.com/oauth/v1/token.

    • Authorization URL – This field is auto-populated as https://app.hubspot.com/oauth/authorize.

    • Redirect URL – This field is auto-populated as https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback.

  6. Choose Next, review the actions for HubSpot, and then choose Next again.

  7. Specify who can access the connector:

    • To share with a team, enter a team name or group email.

    • To keep it private, leave the field blank.

    • To share with all users, toggle Everyone in your organization.

  8. Choose Publish.

The connector appears in the Available panel with a status of Connected.

Using available actions

After you set up the connector, you can use the following read-only actions to access your HubSpot CRM data.

HubSpot available actions
Action Description
Get CRM Objects Fetches multiple CRM objects of the same object type in a single request.
Get properties Fetches properties for the CRM objects.
Get user details Fetches user details.
Search CRM Objects Searches across CRM objects.
Search Owners Searches across owners.
Search properties Searches across properties.
Note

This connector supports read-only actions. The actions that you can use depend on the scopes configured in your HubSpot app.

Troubleshooting

To edit, share, or delete your connector, see Managing existing integrations.

Resolving authentication issues

  • Sign-in fails – Verify that your HubSpot account is active and that you can sign in to the HubSpot sign-in page on the HubSpot website. If your organization uses single sign-on (SSO), confirm that your identity provider is configured correctly.

  • Access denied – Confirm that your HubSpot user has an admin role with permissions to access CRM data. Verify that the client ID and client secret from your app are correct and that the required read scopes are configured.