# Hubspot Custom Objects

> Use when the user works with HubSpot custom object schemas and records (portal-defined object types beyond contacts/companies/deals/tickets) via the `hubspot` command-line tool.

- **Type:** Skill
- **Install:** `agentstack add skill-dipankar-hubspot-cli-hubspot-custom-objects`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dipankar](https://agentstack.voostack.com/s/dipankar)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dipankar](https://github.com/dipankar)
- **Source:** https://github.com/dipankar/hubspot-cli/tree/main/assets/skills/hubspot-custom-objects

## Install

```sh
agentstack add skill-dipankar-hubspot-cli-hubspot-custom-objects
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# HubSpot Custom Objects (via `hubspot` CLI)

Custom objects are portal-specific object types beyond the built-in ones. Always discover the schema before operating on records.

## Auth

Set `HUBSPOT_ACCESS_TOKEN`. Optional `--profile `.

## Discovery first

```bash
# List every custom object type in the portal
hubspot crm custom-objects list-types

# List properties on a type (replace )
hubspot discover properties 
```

Type names look like `p12345_cars` or a fully-qualified `2-12345` object-type id. Use whatever `list-types` returns.

## Canonical commands

| Intent | Command |
| --- | --- |
| List schemas | `hubspot crm custom-objects list-types` |
| List records | `hubspot crm custom-objects list  --limit 20` |
| Get | `hubspot crm custom-objects get  ` |
| Create | `hubspot crm custom-objects create  --properties '{"name":"X","vin":"ABC"}'` |
| Update | `hubspot crm custom-objects update   --properties '{"name":"Y"}'` |
| Delete | `hubspot crm custom-objects delete   --yes` |

## Associations

Custom-object records can associate to any standard object:

```bash
hubspot crm associations create   contacts 67890
hubspot crm associations list   deals
```

## Output / errors

Envelope matches other CRM objects. Extra error code to handle: `SCHEMA_NOT_FOUND` (exit 6) — the `` argument is wrong; run `list-types`.

## Scopes

- Read: `crm.schemas.custom.read`, `crm.objects.custom.read`
- Write: `crm.schemas.custom.write`, `crm.objects.custom.write`

## Tips

- Custom object type names are portal-specific. Never hard-code a type in a reusable script — discover first.
- Required properties on create vary per schema. If a create returns `VALIDATION_ERROR`, run `hubspot discover properties ` and look for `"required": true`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dipankar](https://github.com/dipankar)
- **Source:** [dipankar/hubspot-cli](https://github.com/dipankar/hubspot-cli)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dipankar-hubspot-cli-hubspot-custom-objects
- Seller: https://agentstack.voostack.com/s/dipankar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.