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

# HubSpot

> Connect HubSpot to your Atako agents — 17 read and 20 write actions.

Let your agents work in your HubSpot CRM — contacts, companies, deals, tickets, tasks, notes, owners and marketing emails.

## Connection

* **Authentication**: API key (Private App access token).

<Note>
  HubSpot → Settings → Integrations → Private Apps → Create a private app. Under Scopes, grant "crm.objects.contacts.read/write", "crm.objects.companies.read/write", "crm.objects.deals.read/write", "tickets", "crm.objects.owners.read" — plus "crm.schemas.contacts.write" (and companies/deals) if the agent should create properties, and "content" for marketing emails. Then copy the access token (starts with pat-).

  See [HubSpot's documentation](https://developers.hubspot.com/docs/api/private-apps).
</Note>

## Read actions (17)

| Action                | Description                                                                       |
| --------------------- | --------------------------------------------------------------------------------- |
| `get_company`         | Fetch a single CRM company by id.                                                 |
| `get_contact`         | Fetch a single CRM contact by id.                                                 |
| `get_deal`            | Fetch a single CRM deal by id.                                                    |
| `get_marketing_email` | Fetch a single marketing email by id.                                             |
| `get_owner`           | Fetch a single CRM owner by id.                                                   |
| `get_task`            | Fetch a single CRM task by id.                                                    |
| `get_ticket`          | Fetch a single support ticket by id.                                              |
| `list_companies`      | List CRM companies (paged).                                                       |
| `list_contacts`       | List CRM contacts (paged).                                                        |
| `list_deals`          | List CRM deals (paged).                                                           |
| `list_owners`         | List CRM owners (users records can be assigned to), optionally filtered by email. |
| `list_pipelines`      | List pipelines and their stages for deals or tickets.                             |
| `list_tickets`        | List support tickets (paged).                                                     |
| `search_companies`    | Search CRM companies by text query and/or property filters.                       |
| `search_contacts`     | Search CRM contacts by text query and/or property filters.                        |
| `search_deals`        | Search CRM deals by text query and/or property filters.                           |
| `search_tickets`      | Search support tickets by text query and/or property filters.                     |

## Write actions (20)

| Action                   | Description                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------- |
| `create_association`     | Associate two CRM records with the default association type (e.g. contact ↔ company). |
| `create_company`         | Create a CRM company.                                                                 |
| `create_contact`         | Create a CRM contact.                                                                 |
| `create_deal`            | Create a CRM deal.                                                                    |
| `create_marketing_email` | Create a draft marketing email.                                                       |
| `create_note`            | Log a note in the CRM (attach it to records with create\_association).                |
| `create_property`        | Create a custom CRM property on an object type.                                       |
| `create_task`            | Create a CRM task (to-do, call or email follow-up).                                   |
| `create_ticket`          | Create a support ticket.                                                              |
| `delete_company`         | Archive (delete) a CRM company.                                                       |
| `delete_contact`         | Archive (delete) a CRM contact.                                                       |
| `delete_deal`            | Archive (delete) a CRM deal.                                                          |
| `delete_marketing_email` | Delete a marketing email.                                                             |
| `delete_task`            | Archive (delete) a CRM task.                                                          |
| `delete_ticket`          | Archive (delete) a support ticket.                                                    |
| `update_company`         | Update properties of a CRM company.                                                   |
| `update_contact`         | Update properties of a CRM contact.                                                   |
| `update_deal`            | Update properties of a CRM deal (e.g. move stage, change amount).                     |
| `update_task`            | Update properties of a CRM task (e.g. mark hs\_task\_status COMPLETED).               |
| `update_ticket`          | Update properties of a support ticket (e.g. change stage or priority).                |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.