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

# HubSpot

> Manage contacts, deals, companies, tickets, notes, and tasks in HubSpot CRM.

# HubSpot

Sync CRM data, automate pipeline stages, and trigger workflows from HubSpot contact and deal events. Covers the full contact lifecycle from creation through deal close.

## Authentication

**Auth type:** API Key (Private App Token)

Create a private app in [HubSpot Settings → Integrations → Private Apps](https://app.hubspot.com/private-apps). Grant scopes: `crm.objects.contacts.read`, `crm.objects.contacts.write`, `crm.objects.deals.read`, `crm.objects.deals.write`, `crm.objects.companies.write`.

| Credential       | Description                            |
| ---------------- | -------------------------------------- |
| **Access Token** | Private app token (starts with `pat-`) |

## Triggers

| Trigger                | When it fires                              |
| ---------------------- | ------------------------------------------ |
| **Contact Created**    | A new HubSpot contact is created           |
| **Contact Updated**    | A contact's property value is changed      |
| **Deal Created**       | A new deal is added to the pipeline        |
| **Deal Stage Changed** | A deal moves to a different pipeline stage |
| **Deal Won**           | A deal is marked as closed-won             |
| **Deal Lost**          | A deal is marked as closed-lost            |
| **Company Created**    | A new company record is created            |
| **Ticket Created**     | A new support ticket is opened             |

## Actions

<AccordionGroup>
  <Accordion title="Contacts">
    | Action              | Key inputs                                           | Key outputs                                         |
    | ------------------- | ---------------------------------------------------- | --------------------------------------------------- |
    | **Create Contact**  | `email`, `firstName`, `lastName`, `phone`, `company` | contactId, email                                    |
    | **Update Contact**  | `contactId`, `properties{}`                          | contactId                                           |
    | **Get Contact**     | `contactId`                                          | contactId, email, firstName, lastName, properties{} |
    | **Search Contacts** | `filterProperty`, `filterValue`, `limit`             | contacts\[], count                                  |
  </Accordion>

  <Accordion title="Deals">
    | Action          | Key inputs                                                                        | Key outputs                                |
    | --------------- | --------------------------------------------------------------------------------- | ------------------------------------------ |
    | **Create Deal** | `dealName`, `pipeline`, `dealStage`, `amount`, `closeDate`, `associatedContactId` | dealId, dealName                           |
    | **Update Deal** | `dealId`, `properties{}`                                                          | dealId                                     |
    | **Get Deal**    | `dealId`                                                                          | dealId, dealName, stage, amount, closeDate |
  </Accordion>

  <Accordion title="Companies, notes & tasks">
    | Action             | Key inputs                                             | Key outputs       |
    | ------------------ | ------------------------------------------------------ | ----------------- |
    | **Create Company** | `name`, `domain`, `industry`                           | companyId, name   |
    | **Create Note**    | `body`, `contactId`, `dealId`                          | noteId            |
    | **Create Task**    | `subject`, `body`, `dueDate`, `priority`, `contactId`  | taskId, subject   |
    | **Create Ticket**  | `subject`, `content`, `pipeline`, `status`, `priority` | ticketId, subject |
  </Accordion>
</AccordionGroup>