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

# HubSpot connector

> Set up the HubSpot connector in Collabase Automation: API Key authentication, 8 triggers such as Contact Created and 11 actions such as Create Contact.

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>