HubSpot CRM Schemas

Name: HubSpot CRM Schemas API
Brand: HubSpot CRM Schemas
Availability: InStock

✓ Official Vendor SpecCRMContact Managementoauth27 EndpointsREST

Install Jentic One Beta

Connect the HubSpot CRM Schemas to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the HubSpot CRM Schemas, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Feu1.hubspot.com%2Fhubspot-crm-schemas" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Feu1.hubspot.com%2Fhubspot-crm-schemas" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with HubSpot CRM Schemas API.

Define a new custom object schema with name, properties and primary display fields

Retrieve every custom object schema configured on the account

Update an existing schema to add new properties or change associations

GET STARTED

Start building with HubSpot CRM Schemas API

Explore with Jentic One

View OpenAPI Document

For Agents

Create, retrieve, update and delete HubSpot custom object schemas, and define associations between schema types on the EU region.

Use for: I need to create a new custom object schema for vehicles, List all custom object schemas defined on the account, Retrieve the schema for a specific objectType, Update a schema to add a new property

Not supported: Does not manage record-level data, contacts, or marketing automation - use for defining custom object schemas and their associations only.

Use Cases

Patterns agents use HubSpot CRM Schemas API for, with concrete tasks.

★ Custom object schema design

Define a new custom object type such as Subscription with a controlled set of properties and a primary display property before any records exist. POST /crm-object-schemas/v3/schemas accepts the name, labels, requiredProperties and primaryDisplayProperty, and HubSpot returns the objectTypeId used by the Custom Objects API. Schema design is a one-time set-up activity per object type.

POST /crm-object-schemas/v3/schemas with name 'subscription', a labels block, requiredProperties for plan_tier and start_date, then capture the returned objectTypeId.

Schema audit and inventory

Inventory every custom object schema in the account so administrators know which types exist and what properties they expose. GET /crm-object-schemas/v3/schemas returns an array of schema definitions which can be exported as documentation for downstream teams.

GET /crm-object-schemas/v3/schemas, then write each schema's name, objectTypeId and property list into a CSV for the data team.

Schema evolution

Add or rename properties on an existing schema as the business model evolves. PATCH /crm-object-schemas/v3/schemas/{objectType} updates the schema in place; properties cannot be deleted but can be archived, so plan the rollout carefully.

PATCH /crm-object-schemas/v3/schemas/{objectType} adding a new property definition, then verify it appears in the GET response.

Cross-schema associations

Connect two custom object types so HubSpot records can be linked together (for example, a Vehicle to a Service Visit). POST /crm-object-schemas/v3/schemas/{objectType}/associations defines a typed association which is then usable from the Custom Objects associations endpoints.

POST /crm-object-schemas/v3/schemas/vehicle/associations with toObjectTypeId of the service_visit schema and a name 'vehicle_to_service_visit'.

Agent-driven schema bootstrap via Jentic

An AI agent provisioning a new HubSpot environment reads a schema definition from a YAML file and uses the Schemas API through Jentic to create each custom object type and its associations in order. Jentic isolates the OAuth credentials and resolves the right endpoint per intent.

Search Jentic for 'create a HubSpot custom object schema', load the schema for POST /crm-object-schemas/v3/schemas, and execute for each entry in the YAML.

Key Endpoints

7 endpoints — the hubspot crm schemas api defines the structure of custom objects in hubspot's crm on the eu region.

METHOD

PATH

DESCRIPTION

GET

/crm-object-schemas/v3/schemas

List all custom object schemas

POST

/crm-object-schemas/v3/schemas

Create a new schema

GET

/crm-object-schemas/v3/schemas/{objectType}

Read a single schema

PATCH

/crm-object-schemas/v3/schemas/{objectType}

Update a schema

DELETE

/crm-object-schemas/v3/schemas/{objectType}

Delete a schema

POST

/crm-object-schemas/v3/schemas/{objectType}/associations

Create an association definition

DELETE

/crm-object-schemas/v3/schemas/{objectType}/associations/{associationIdentifier}

Remove an association

GET

/crm-object-schemas/v3/schemas

List all custom object schemas

POST

/crm-object-schemas/v3/schemas

Create a new schema

GET

/crm-object-schemas/v3/schemas/{objectType}

Read a single schema

PATCH

/crm-object-schemas/v3/schemas/{objectType}

Update a schema

DELETE

/crm-object-schemas/v3/schemas/{objectType}

Delete a schema

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring HubSpot CRM Schemas by hand means running its OAuth2 flow, refreshing tokens against the api.hubapi.com host, and shaping the requiredProperties and label payloads for schema definitions yourself. Through Jentic you install once, import HubSpot CRM Schemas from the API Directory, store the OAuth credentials once, and your agent calls it.

Permission scoping

HubSpot puts the object type in the URL path (/crm-object-schemas/v3/schemas/{objectType}), so a rule can pin your agent to reading or updating one object type's schema and nothing else. You choose the operations it may call, so DELETE /schemas/{objectType} is not included unless you add it.

Credential isolation

Your HubSpot OAuth refresh token and client secret are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'define a HubSpot custom object schema', and Jentic returns the matching POST /crm-object-schemas/v3/schemas operation with its requiredProperties and labels schema so the agent calls the right endpoint without interpreting the schema-modelling reference manually.

FAQs

Specific to using HubSpot CRM Schemas API through Jentic.

What authentication does the HubSpot CRM Schemas API use?

OAuth 2.0 authorization-code flow. The required scopes are crm.schemas.custom.read and crm.schemas.custom.write. Through Jentic the refresh token is stored in your Jentic One instance and a scoped access token is injected per call.

Can I delete a custom object schema with this API?

Yes. DELETE /crm-object-schemas/v3/schemas/{objectType} removes the schema, but only if no records of that type exist. Archive or delete the records via the Custom Objects API first.

How do I add a new property to an existing schema?

Call PATCH /crm-object-schemas/v3/schemas/{objectType} with a properties array containing the new field. HubSpot does not allow property deletion, only archiving, so design the field set carefully before the schema is live.

What are the rate limits for the HubSpot CRM Schemas API?

Schema operations are administrative and share the standard HubSpot CRM v3 rate limits, which depend on subscription tier. The OpenAPI spec does not encode the exact ceiling - watch for 429 responses in production.

How do I create a schema through Jentic?

Use the Jentic search query 'create a HubSpot custom object schema', which resolves to POST /crm-object-schemas/v3/schemas. Run pip install jentic, load the operation, and execute with the schema definition.

Do I need HubSpot Enterprise to use the Schemas API?

Yes. Custom object schema management requires HubSpot Enterprise. Lower tiers can read schemas for the standard objects but cannot create new custom object types.

Can I limit what my agent is allowed to do with the HubSpot CRM Schemas API?

Yes. Jentic One is self-hosted by you, so your own rules decide which schema operations the agent may call and which HubSpot credentials it may use. Because the object type sits in the URL path (/crm-object-schemas/v3/schemas/{objectType}), you can pin the agent to reading or updating a single object type's schema and nothing else. You choose the exact operations it can reach, so a destructive call like DELETE /crm-object-schemas/v3/schemas/{objectType} stays out of scope unless you explicitly add it.

HubSpot CRM Schemas

Connect the HubSpot CRM Schemas to your agent

Capabilities

Start building with HubSpot CRM Schemas API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs