HubSpot CRM Schemas

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

✓ Official Vendor SpecCRMContact Managementoauth27 EndpointsREST

For Agents

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

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.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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

Delete a custom object schema that is no longer in use

GET STARTED

Start building with HubSpot CRM Schemas API

Explore with Jentic

View OpenAPI Document

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 though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

HubSpot OAuth refresh tokens and client secrets are stored in the Jentic MAXsystem vault, with crm.schemas.custom.* scopes injected at execution time so the agent only ever sees a short-lived access token.

Intent-based discovery

Agents search 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 does not have to interpret HubSpot's schema-modelling reference manually.

Time to first call

Direct HubSpot Schemas integration: 1-2 days to wire OAuth, schema modelling rules and association definitions. Through Jentic: under 30 minutes - search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

HubSpot CRM Custom Objects

Manages records for the schemas defined by this API

Use after defining a schema to create, search and update records of that custom object type

Alternative

Salesforce API

Salesforce custom object metadata is managed via the Metadata API for similar schema-design needs

Choose Salesforce when the agent designs custom data models inside a Salesforce-based CRM

Alternative

Zoho CRM API

Zoho CRM modules and fields offer comparable custom data modelling

Choose Zoho CRM when the agent works in the Zoho ecosystem rather than HubSpot

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 the MAXsystem vault 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.