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

# HubSpot

> Connect your HubSpot CRM to your AI agent

## Setup

<Steps>
  <Step title="Create a Private App in HubSpot">
    1. Go to **Settings → Integrations → Private Apps** in HubSpot
    2. Click **Create a private app**
    3. Name it "Orova Integration"
    4. Under **Scopes**, enable: `crm.objects.contacts`, `crm.objects.deals`, `crm.objects.companies`
    5. Click **Create app** and copy the access token
  </Step>

  <Step title="Add credentials in Orova">
    Go to **Settings → Integrations → HubSpot** and paste your access token.
  </Step>

  <Step title="Create a tool">
    Go to **Tools → Create Tool** and select the **HubSpot** template.
  </Step>

  <Step title="Assign to your agent">
    In your agent's settings, add the HubSpot tool.
  </Step>
</Steps>

## Available tools

| Tool                | Description                              |
| ------------------- | ---------------------------------------- |
| `search_contacts`   | Search contacts by name, email, or phone |
| `get_contact`       | Get contact details by ID                |
| `create_contact`    | Create a new contact                     |
| `update_contact`    | Update contact properties                |
| `search_companies`  | Search companies                         |
| `get_company`       | Get company details                      |
| `create_company`    | Create a new company                     |
| `search_deals`      | Search deals                             |
| `get_deal`          | Get deal details                         |
| `create_deal`       | Create a new deal                        |
| `update_deal`       | Update deal properties                   |
| `get_deal_pipeline` | Get deal pipeline stages                 |
| `search_tickets`    | Search support tickets                   |
| `get_ticket`        | Get ticket details                       |
| `create_ticket`     | Create a support ticket                  |
| `create_note`       | Create a note on a record                |
| `create_task`       | Create a task                            |
| `get_owners`        | List HubSpot owners                      |

## Example conversation

> **User**: "Can you look up John Smith in our CRM?"
>
> **Agent**: *calls `search_contacts` with query "John Smith"*
>
> **Agent**: "I found John Smith — he's a Sales Manager at Acme Corp. His email is \[email]. Would you like me to create a deal for him?"