> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot Integration

> Configure HubSpot CRM integration

## Overview

CrewAI supports integration with HubSpot CRM, enabling your crews to interact with contacts, companies, deals, tickets, and products.

## Prerequisites

* A HubSpot account (any tier)
* Access to the HubSpot Developer Portal
* Admin permissions in your HubSpot account to install apps

## HubSpot App Setup

### Step 1: Access the Developer Portal

1. Navigate to the [HubSpot Developer Portal](https://developers.hubspot.com/)
2. Sign in with your HubSpot account
3. If you don't have a developer account, click **Create a developer account**

### Step 2: Create a New App

1. In the Developer Portal, click **Apps** in the top navigation
2. Click **Create app**
3. Fill in the app details:
   * **App name**: Enter a name (e.g., "CrewAI Integration")
   * **Description**: Optional description of the integration
   * **Logo**: Optional logo for the app

### Step 3: Configure OAuth Settings

1. In your app settings, navigate to the **Auth** tab

2. Under **Redirect URLs**, add:

   **Default configuration (NGINX with shared hostname):**

   ```
   https://<YOUR_APPLICATION_HOST>/oauthsvc/oauth/add
   ```

   **Separate OAuth hostname (GKE/ALB with `path: "/"`):**

   ```
   https://<YOUR_OAUTH_HOST>/oauth/add
   ```

   See [OAuth Redirect URI Patterns](/features/built-in-integrations-overview#oauth-redirect-uri-patterns) for the correct redirect URI format based on your ingress configuration.

3. Under **Scopes**, select the scopes required for your use case (see [Required Scopes](#required-scopes) below)

### Step 4: Get Your Credentials

1. In the **Auth** tab, locate your credentials:
   * **Client ID**: Your app's unique identifier
   * **Client Secret**: Click **Show** to reveal the secret

2. Store these credentials securely for CrewAI configuration

## Required Scopes

Select the scopes based on the HubSpot features you want to use with CrewAI:

### Contacts

| Scope                        | Description                       |
| ---------------------------- | --------------------------------- |
| `crm.objects.contacts.read`  | Read contact records              |
| `crm.objects.contacts.write` | Create and update contact records |

### Deals

| Scope                     | Description                    |
| ------------------------- | ------------------------------ |
| `crm.objects.deals.read`  | Read deal records              |
| `crm.objects.deals.write` | Create and update deal records |

### Companies

| Scope                         | Description                       |
| ----------------------------- | --------------------------------- |
| `crm.objects.companies.read`  | Read company records              |
| `crm.objects.companies.write` | Create and update company records |

### Tickets

| Scope     | Description                    |
| --------- | ------------------------------ |
| `tickets` | Full access to support tickets |

### Products

| Scope        | Description                            |
| ------------ | -------------------------------------- |
| `e-commerce` | Access to products and e-commerce data |

## Complete Scopes Summary

For full CRM integration, add all of the following scopes:

| Scope                         | Purpose         |
| ----------------------------- | --------------- |
| `crm.objects.contacts.read`   | Read contacts   |
| `crm.objects.contacts.write`  | Write contacts  |
| `crm.objects.deals.read`      | Read deals      |
| `crm.objects.deals.write`     | Write deals     |
| `crm.objects.companies.read`  | Read companies  |
| `crm.objects.companies.write` | Write companies |
| `tickets`                     | Access tickets  |
| `e-commerce`                  | Access products |

## Configure CrewAI Helm Values

Add your HubSpot credentials to your CrewAI Helm values:

```yaml theme={null}
oauth:
  enabled: true
  secrets:
    hubspot:
      clientId: "your-hubspot-client-id"
      clientSecret: "your-hubspot-client-secret"
```

See [Built-in Integrations Configuration](/reference/chart-values/oauth) for complete configuration options.

## Activate the Integration

After deploying your updated Helm values, sync integrations to make them available to users — see [Activate Integrations After Deployment](/features/built-in-integrations-overview#activate-integrations-after-deployment).

## Related Guides

* [Google Workspace Integrations](/features/google-integrations) - Gmail, Calendar, Drive, Sheets, Slides, Docs, Contacts
* [Microsoft 365 Integrations](/features/microsoft-integrations) - Outlook, OneDrive, Teams, SharePoint, Excel, Word
* [Notion Integration](/features/notion-integration) - Workspaces, databases, pages, and comments