hubspot

# HubSpot

Interact with HubSpot CRM directly via the HubSpot API (`api.hubapi.com`).

## Setup (one-time)

1. In HubSpot: Settings → Integrations → Private Apps → Create a private app
2. Give it scopes: `crm.objects.contacts.read`, `crm.objects.contacts.write`, `crm.objects.companies.read`, `crm.objects.companies.write`, `crm.objects.deals.read`, `crm.objects.deals.write`, `tickets`
3. Copy the access token
4. Set environment variable:
   ```
   HUBSPOT_TOKEN=pat-na1-...
   ```

## Queries

### Search contacts
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search contacts --query "john"
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search contacts --email "john@example.com"
```

### List contacts
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list contacts --limit 20
```

### Get a specific object
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get contacts 12345
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get companies 67890
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py get deals 11111
```

### List companies
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list companies --limit 20
```

### Search companies
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search companies --query "Acme"
```

### List deals
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list deals --limit 20
```

### Search deals
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py search deals --query "enterprise"
```

### List tickets
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py list tickets --limit 20
```

### Create a contact
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create contacts --email "new@example.com" --firstname "Jane" --lastname "Doe"
```

### Create a company
```bash
python3 /mnt/skills/user/hubspot/scripts/hubspot_query.py create companies --name "Acme Corp" --domain "acme.com"
```...

# hubspot

An [OpenClaw](https://clawhub.ai) skill for querying and managing your HubSpot CRM — directly via `api.hubapi.com`, no third-party proxy.

## What it does

Search and manage contacts, companies, deals, and tickets. Create and update CRM records, associate objects, inspect pipelines, and list owners.

## Setup

**1. Create a HubSpot private app**

Go to HubSpot → Settings → Integrations → Private Apps → Create a private app.

Required scopes:

```
crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.companies.read
crm.objects.companies.write
crm.objects.deals.read
crm.objects.deals.write
tickets
```

**2. Set the environment variable**

```bash
export HUBSPOT_TOKEN=pat-na1-...
```

## Supported objects

| Object | List | Search | Get | Create | Update | Associate |
|---|---|---|---|---|---|---|
| contacts | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| companies | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| deals | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| tickets | ✅ | | ✅ | ✅ | ✅ | ✅ |

## Usage

### List

```bash
python3 scripts/hubspot_query.py list contacts --limit 20
python3 scripts/hubspot_query.py list companies --limit 20
python3 scripts/hubspot_query.py list deals --limit 20
python3 scripts/hubspot_query.py list tickets --limit 20
```

### Search

```bash
python3 scripts/hubspot_query.py search contacts --query "john"
python3 scripts/hubspot_query.py search contacts --email "john@acme.com"
python3 scripts/hubspot_query.py search companies --query "Acme"
python3 scripts/hubspot_query.py search deals --query "enterprise"
```

### Get

```bash
python3 scripts/hubspot_query.py get contacts 12345
python3 scripts/hubspot_query.py get companies 67890
python3 scripts/hubspot_query.py get deals 11111
```

### Create

```bash
python3 scripts/hubspot_query.py create contacts --email "jane@acme.com" --firstname "Jane" --lastname "Doe"
python3 scripts/hubspot_query.py create companies --name "Acme Corp" --domain "acme.com"
python3 scripts/hubspot_query.py create deals --dealnam...