
Custom Object Management
This handles the full lifecycle of custom CRM object schemas in HubSpot: list what exists, inspect definitions, create new object types with properties and associations, update labels, and delete schemas (with a three-step safety flow since it's destructive and wipes all records). It's schema management only. Once you've defined a custom object, all the normal record operations (CRUD, search, bulk upsert) work through the standard objects commands covered in bulk-operations. The create flow is straightforward JSON, and the delete protection is solid: dry run first, get a digest, then confirm within five minutes using the schema name. If you're extending HubSpot's data model beyond contacts and deals, this is how you do it.
- skills.sh installs
- 1.8K
- GitHub stars
- 29
- last updated
- Aug 21, 2026
Install
$ npx -y skills add hubspot/agent-cli-skills --skill custom-object-management --agent claude-codeInstalls into .claude/skills of the current project.
Files
Source of truth
hubspot schemas --help is authoritative. Subcommands: list, get, create, update (metadata only), delete (destructive). schemas list/get/create/update work under OAuth login or a service key; schemas delete is service-key-only (AppTokenOnly) — set HUBSPOT_ACCESS_TOKEN. Read bulk-operations/SKILL.md first — every command here uses its JSONL conventions, and schemas delete uses its dry-run / digest / confirm flow.
Discover existing schemas
hubspot schemas list # JSONL: name, label, singular, objectTypeId, source
hubspot schemas list | jq 'select(.source=="custom")' # custom only
hubspot objects types | jq -c 'select(.source=="custom")' # same set, also shown to confirm `--type` resolves
name is what every other command takes. objectTypeId (e.g. 2-12345678) is only needed for workflow PLATFORM_FLOW targets.
Inspect one schema
hubspot schemas get --type pets
Sponsors
Details
- Repository
- github.com/hubspot/agent-cli-skills
- Categories
- AI & Agent Building, Sales & Marketing, CLI & Terminal
- First seen
- Jul 14, 2026