# Aai Hubspot

> Use aai-cli to inspect HubSpot CRM records, files, events, conversations, visitor identification, and custom channels.

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

---


# aai-cli HubSpot

Use this skill when working with HubSpot through `aai-cli hubspot`.

Before running commands, confirm the active profile or pass `--profile`. HubSpot profiles use `auth_type = "hubspot_service_key"` or `auth_type = "hubspot_legacy_private_app"` with `token_secret`.

HubSpot `401` and `403` errors include scope and auth-model remediation under `details`. Preserve that JSON when reporting failures. Custom channel commands are not supported for legacy private app tokens and return `unsupported_auth` before making a request.

Successful output is JSON on stdout. Errors are structured JSON on stderr. See [the command reference](references/command-reference.md) for command shapes, scopes, and failure handling.