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

# HubSpot

> Contacts, companies and deals. Who asked, what they asked about, and whether it ever closed.

Contacts, companies and deals. Who asked, what they asked about, and whether it ever closed.

## Connecting

In the dashboard, open **Connectors**, find HubSpot and press **Connect**. The key you enter is checked against HubSpot before anything is saved, so a key that is refused never becomes a connection that fails later.

### What you will need

| Field | What it is |
| - | - |
| Access Token | Your HubSpot API key or private app access token |

### Getting the credential

1. Log in to [HubSpot](https://app.hubspot.com)
2. Go to **Settings** → **Integrations** → **Private Apps**
3. Click **Create a private app**
4. Configure app name and description
5. Select required scopes:
   * `crm.objects.contacts.read/write` - Contact management
   * `crm.objects.companies.read/write` - Company management
   * `crm.objects.deals.read/write` - Deal management
   * `transactional-email` - Send emails
6. Install the app and copy the access token

## What your AI teammate can do with it

| Tool | What it does |
| - | - |
| `get_contacts` | List contacts |
| `get_contact` | Get contact by ID |
| `create_contact` | Create a new contact |
| `update_contact` | Update an existing contact |
| `delete_contact` | Archive a contact |
| `search_contacts` | Search for contacts |
| `get_companies` | List companies |
| `create_company` | Create a new company |
| `get_deals` | List deals |
| `create_deal` | Create a new deal |
| `get_pipelines` | Get deal pipelines |
| `get_owners` | List owners |
| `get_properties` | Get properties for an object type |
| `create_engagement` | Create an engagement (note, email, call, etc.) |
| `get_activities` | Get activities for a contact |
| `send_email` | Send a single email |
| `get_email_events` | Get email events |

## Useful resources

* [HubSpot documentation](https://developers.hubspot.com/docs/api/private-apps)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.