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

# HubSpot

> Access HubSpot forms, submissions, contacts, and leads

## At a glance

* **Availability**: Enabled by default.
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `oauth`, `crm.objects.contacts.read`.
* **Optional scopes**: `forms`, `crm.objects.leads.read`, `crm.objects.leads.write`.

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                | Required | Description                                                                                                                      |
| ----------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `HUBSPOT_CLIENT_ID`     | Yes      | HubSpot OAuth Client ID [Docs](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/oauth).     |
| `HUBSPOT_CLIENT_SECRET` | Yes      | HubSpot OAuth Client Secret [Docs](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/oauth). |

## Tools

| Tool                    | Access | Description                                                                                 |
| ----------------------- | ------ | ------------------------------------------------------------------------------------------- |
| List Forms              | Read   | List HubSpot forms so agents can find a form ID before reading submissions                  |
| List Form Submissions   | Read   | List recent submissions for a HubSpot form in reverse chronological order                   |
| Get Contact             | Read   | Get a HubSpot contact by ID or email before scoring, dedupe, or updates                     |
| Search Contacts         | Read   | Search HubSpot contacts by filters for lead research and CRM lookup                         |
| Create Contact          | Write  | Create a HubSpot contact from form submission or researched lead data                       |
| Update Contact          | Write  | Update HubSpot contact properties, including lead score or research notes                   |
| Get Lead                | Read   | Get a HubSpot CRM lead before scoring, routing, or updates                                  |
| List Leads              | Read   | List HubSpot CRM leads for scoring, spreadsheet updates, or research workflows              |
| Search Leads            | Read   | Search HubSpot CRM leads for dedupe, scoring, and routing workflows                         |
| Create Lead             | Write  | Create a HubSpot CRM lead associated with an existing contact or company                    |
| Update Lead             | Write  | Update a HubSpot CRM lead with score, qualification, owner, or research fields              |
| Get Company             | Read   | Get a HubSpot company by ID or domain before lead research or association                   |
| Search Companies        | Read   | Search HubSpot companies by domain, name, or firmographic properties                        |
| Create Company          | Write  | Create a HubSpot company for researched lead accounts                                       |
| Update Company          | Write  | Update HubSpot company properties with research or enrichment data                          |
| List Properties         | Read   | List HubSpot CRM properties for contacts, leads, or companies before updating custom fields |
| List Owners             | Read   | List HubSpot owners so agents can assign or route contacts and leads                        |
| List Association Labels | Read   | List HubSpot association labels between CRM object types before associating records         |
| List Associations       | Read   | List records associated with a HubSpot CRM record                                           |
| Associate Records       | Write  | Create a default HubSpot association between two CRM records                                |
| Remove Association      | Write  | Remove all HubSpot associations between two CRM records                                     |

## Example prompts

* List recent HubSpot form submissions, identify the strongest leads, and summarize recommended follow-up.
* Research HubSpot contacts or leads, score them, and update the matching CRM records.