> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airweave.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server.

# Hubspot

> Hubspot integration with Airweave

{/* AUTO-GENERATED CONTENT START */}

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/airweave.docs.buildwithfern.com/2026-05-20T11%3A36%3A51.367Z/docs/pages/connectors/hubspot/icon.svg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260807%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T163159Z&X-Amz-Expires=604800&X-Amz-Signature=fc27ec0722330c1179cc0a2ab16360b29d1c938ad94b02abc306953669d6764f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="Hubspot logo" width="48" height="48" />

<h1>
  Hubspot
</h1>

This connector enables AI agents and RAG systems to retrieve context from Hubspot through Airweave's unified search layer.

## Configuration

HubSpot source connector integrates with the HubSpot CRM API to extract CRM data.

Synchronizes customer relationship management data.

It provides comprehensive access to contacts, companies, deals, and support tickets.

#### [View Source Code](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/hubspot.py)

Explore the Hubspot connector implementation

### Authentication

This connector uses **OAuth 2.0 authentication**. You can connect through the Airweave UI or API using the OAuth flow.

**Supported authentication methods:**

* OAuth Browser Flow (recommended for UI)
* OAuth Token (for programmatic access)
* Auth Provider (enterprise SSO)

### Configuration Options

This connector does not have any additional configuration options.

## Data Models

The following data models are available for this connector:

#### HubspotContactEntity

Schema for HubSpot contact entities with flexible property handling.

Reference:
[https://developers.hubspot.com/docs/api/crm/contacts](https://developers.hubspot.com/docs/api/crm/contacts)

| Field           | Type            | Description                                         |
| --------------- | --------------- | --------------------------------------------------- |
| contact\_id     | str             | The HubSpot contact ID.                             |
| display\_name   | str             | Display name derived from first/last name or email. |
| created\_time   | datetime        | When the contact was created.                       |
| updated\_time   | datetime        | When the contact was last updated.                  |
| first\_name     | Optional\[str]  | The contact's first name                            |
| last\_name      | Optional\[str]  | The contact's last name                             |
| email           | Optional\[str]  | The contact's email address                         |
| properties      | Dict\[str, Any] | All properties from HubSpot contact object          |
| archived        | bool            | Whether the contact is archived                     |
| web\_url\_value | Optional\[str]  | URL to view this contact in HubSpot.                |

#### HubspotCompanyEntity

Schema for HubSpot company entities with flexible property handling.

Reference:
[https://developers.hubspot.com/docs/api/crm/companies](https://developers.hubspot.com/docs/api/crm/companies)

| Field           | Type            | Description                                |
| --------------- | --------------- | ------------------------------------------ |
| company\_id     | str             | The HubSpot company ID.                    |
| company\_name   | str             | Display name of the company.               |
| created\_time   | datetime        | When the company was created.              |
| updated\_time   | datetime        | When the company was last updated.         |
| domain          | Optional\[str]  | The company's domain name                  |
| properties      | Dict\[str, Any] | All properties from HubSpot company object |
| archived        | bool            | Whether the company is archived            |
| web\_url\_value | Optional\[str]  | URL to view this company in HubSpot.       |

#### HubspotDealEntity

Schema for HubSpot deal entities with flexible property handling.

Reference:
[https://developers.hubspot.com/docs/api/crm/deals](https://developers.hubspot.com/docs/api/crm/deals)

| Field           | Type             | Description                             |
| --------------- | ---------------- | --------------------------------------- |
| deal\_id        | str              | The HubSpot deal ID.                    |
| deal\_name      | str              | The name of the deal.                   |
| created\_time   | datetime         | When the deal was created.              |
| updated\_time   | datetime         | When the deal was last updated.         |
| amount          | Optional\[float] | The monetary value of the deal          |
| properties      | Dict\[str, Any]  | All properties from HubSpot deal object |
| archived        | bool             | Whether the deal is archived            |
| web\_url\_value | Optional\[str]   | URL to view this deal in HubSpot.       |

#### HubspotTicketEntity

Schema for HubSpot ticket entities with flexible property handling.

Reference:
[https://developers.hubspot.com/docs/api/crm/tickets](https://developers.hubspot.com/docs/api/crm/tickets)

| Field           | Type            | Description                               |
| --------------- | --------------- | ----------------------------------------- |
| ticket\_id      | str             | The HubSpot ticket ID.                    |
| ticket\_name    | str             | Display name for the ticket.              |
| created\_time   | datetime        | When the ticket was created.              |
| updated\_time   | datetime        | When the ticket was last updated.         |
| subject         | Optional\[str]  | The subject of the support ticket         |
| content         | Optional\[str]  | The content or description of the ticket  |
| properties      | Dict\[str, Any] | All properties from HubSpot ticket object |
| archived        | bool            | Whether the ticket is archived            |
| web\_url\_value | Optional\[str]  | URL to view this ticket in HubSpot.       |

{/* AUTO-GENERATED CONTENT END */}