# Hubspot

> Query HubSpot CRM contacts, deals, and deal stages via the HubSpot REST API. Use when you need to look up contacts, inspect deals, search the CRM, or review deal stage definitions in HubSpot.

- Skill: `technickai-openclaw-config/hubspot` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add technickai-openclaw-config/hubspot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/technickai-openclaw-config/hubspot/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: TechNickAI (https://skillmd.com/u/technickai-openclaw-config)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/technickai-openclaw-config/hubspot

---


# HubSpot 🟠

Read HubSpot CRM data from the REST API.

## Setup

Create or use a HubSpot private app token, then configure it as `HUBSPOT_API_KEY` in
OpenClaw.

Recommended scopes for this skill:

- `crm.objects.contacts.read`
- `crm.objects.contacts.write` (needed for create/delete contact operations)
- `crm.objects.deals.read`
- `crm.schemas.deals.read`

## What Users Ask

- "Look up this person in HubSpot"
- "Search HubSpot for [name or email]"
- "Show me recent deals"
- "What stage is this deal in?"
- "List the HubSpot deal stages"
- "Open this contact or deal by ID"

## Commands

- `hubspot contacts [query] [--limit N]`
- `hubspot contact <contact_id>`
- `hubspot deals [query] [--limit N]`
- `hubspot deal <deal_id>`
- `hubspot stages`
- `hubspot create-contact --email <email> [--first NAME] [--last NAME] [--phone N] [--company NAME]`
- `hubspot delete-contact <contact_id>`

## Capabilities

- Search contacts by free text
- Fetch a contact by HubSpot ID
- Search deals by free text
- Fetch a deal by HubSpot ID
- Resolve deal stage IDs to readable labels
- List all configured deal pipelines and stages
- Create a contact for testing or workflow setup
- Delete a contact by HubSpot ID

## Notes

- Owner lookup is not included because many HubSpot tokens do not have the extra scopes
  required for the owners API.
- Deal stage labels come from the pipelines API, so stage output stays readable instead
  of showing only internal IDs.
- Create/delete commands only work when the private app has
  `crm.objects.contacts.write`.