stackgate.ai
All integrations

HubSpot

Search and manage HubSpot CRM contacts, companies, deals, notes, and associations.

OAuth 17 tools

Overview

Connect HubSpot to give AI clients access to your CRM contacts, companies, deals, notes, and record associations.

Prerequisites

  • A HubSpot account with CRM access
  • Super Admin or HubSpot Marketplace Access permissions to install OAuth apps
  • A stackgate.ai account

Getting credentials

  1. Sign in to stackgate.ai.
  2. Go to Integrations and open HubSpot.
  3. Click Activate, then Connect HubSpot.
  4. Select your HubSpot portal and approve the OAuth scopes — stackgate.ai stores your access and refresh tokens securely.

No manual API keys are required for the standard connect flow.

Using with AI clients

  • Dedicated endpoint: POST /mcp/hubspot with a Sanctum bearer token
  • Private gateway: one config for all integrations — use hubspot__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured — complete the OAuth connect flow in My Integrations.
  • Auth errors after connecting — disconnect and reconnect HubSpot from the integration page (tokens are revoked when the app is uninstalled).
  • 429 rate limit errors — HubSpot enforces per-portal API limits, including a stricter limit on CRM search endpoints. Reduce request volume or spread searches over time.

Available tools

  • get_portal_info

    Return details about the connected HubSpot portal (account name, hub ID, timezone).

  • search_contacts

    Search HubSpot contacts by text query or filter groups.

  • get_contact

    Get a HubSpot contact by ID with selected properties.

  • search_companies

    Search HubSpot companies by text query or filter groups.

  • get_company

    Get a HubSpot company by ID with selected properties.

  • search_deals

    Search HubSpot deals by text query or filter groups.

  • get_deal

    Get a HubSpot deal by ID with selected properties.

  • search_notes

    Search HubSpot notes by text query or filter groups.

  • get_note

    Get a HubSpot note by ID with selected properties.

  • list_associations

    List associations between HubSpot CRM objects (e.g. contact to company).

  • create_contact

    Create a HubSpot contact with the given CRM properties.

  • update_contact

    Update a HubSpot contact by ID with the given CRM properties.

  • create_company

    Create a HubSpot company with the given CRM properties.

  • update_company

    Update a HubSpot company by ID with the given CRM properties.

  • create_deal

    Create a HubSpot deal with the given CRM properties.

  • update_deal

    Update a HubSpot deal by ID with the given CRM properties.

  • create_note

    Create a HubSpot note and optionally associate it with a contact, company, or deal.

MCP endpoint: https://stackgate.ai/mcp/hubspot (HTTP) or via the private gateway.

Related workflows

Multi-integration playbooks that use HubSpot to solve concrete business outcomes.

Create account Documentation