HubSpot CRM Custom Objects

Name: HubSpot CRM Custom Objects API
Brand: HubSpot CRM Custom Objects
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCRMContact Managementoauth215 EndpointsREST

For Agents

Create, query, batch-process, and associate custom CRM object records in HubSpot. Supports search, merge, upsert, and cross-object associations for any user-defined object type.

Quickstart

Get started with HubSpot CRM Custom Objects in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create a custom object record in HubSpot CRM"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with HubSpot CRM Custom Objects API.

Search custom object records using filters, property values, and full-text queries

Batch-create or upsert hundreds of custom object records in a single API call

Associate custom objects with contacts, companies, deals, or other custom types

Merge duplicate custom object records into a single canonical entry

GET STARTED

Start building with HubSpot CRM Custom Objects API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for HubSpot CRM Custom Objects, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for HubSpot CRM Custom Objects, keeping it validated and agent-ready. Define and operate on bespoke CRM object types that extend HubSpot beyond standard contacts, companies, deals, and tickets. Store industry-specific records — such as vehicles, properties, or subscriptions — with full association, search, batch, and merge support across the HubSpot CRM graph. Requires an Enterprise-tier HubSpot account.

Use Cases

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

★ AI Agent Custom Object Automation

AI agents use HubSpot CRM Custom Objects through Jentic to automate record creation and association for industry-specific data models. An agent can search for matching records by property value, batch-upsert new entries from external systems, and wire associations to standard HubSpot objects — all without manual CRM configuration. Through Jentic, agents discover the correct endpoints via intent search, load the schema, and execute operations in under a minute.

Search for custom object records of type 'vehicle' where the 'vin' property matches a given value, then associate the matching record with an existing contact by contact ID

Industry-Specific CRM Data Modeling

Extend HubSpot CRM to store domain-specific records that do not fit contacts, companies, deals, or tickets. Custom objects let real estate firms track properties, auto dealers track vehicles, or SaaS companies track subscription tiers — each with typed properties, associations, and searchability identical to native HubSpot objects. The API supports up to 10 custom object definitions on Enterprise plans.

Create a batch of 50 custom object records of type 'property_listing' with address, price, and status properties using the batch/create endpoint

Duplicate Record Merging

Identify and merge duplicate custom object records to maintain data hygiene across the CRM. The merge endpoint combines two records by retaining the primary record's ID and associations while absorbing the secondary record's unique data. This is critical for pipelines that ingest data from multiple sources where duplicates are common.

Merge custom object record ID 456 into primary record ID 123 of type 'subscription' using the merge endpoint

Cross-Object Association Management

Build a connected CRM graph by associating custom objects with contacts, companies, deals, tickets, or other custom types. The API supports both labeled and default association types, enabling relationship semantics like 'owned by' or 'related to'. Associations are bidirectional and immediately reflected in the HubSpot UI timeline.

Create a default association between a custom object record of type 'vehicle' (ID 789) and a contact (ID 101) using the PUT associations endpoint

Key Endpoints

15 endpoints — jentic publishes the only available openapi specification for hubspot crm custom objects, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/crm/v3/objects/{objectType}/search

Search custom objects by property filters

POST

/crm/v3/objects/{objectType}

Create a single custom object record

POST

/crm/v3/objects/{objectType}/batch/create

Batch-create custom object records

POST

/crm/v3/objects/{objectType}/batch/upsert

Batch-upsert records by unique property

POST

/crm/v3/objects/{objectType}/merge

Merge two custom object records

PUT

/crm/v3/objects/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId}

Associate a custom object with another record

GET

/crm/v3/objects/{objectType}/{objectId}

Retrieve a single custom object record

GET

/crm/v3/objects/{objectType}

List custom object records by type

POST

/crm/v3/objects/{objectType}/search

Search custom objects by property filters

POST

/crm/v3/objects/{objectType}

Create a single custom object record

POST

/crm/v3/objects/{objectType}/batch/create

Batch-create custom object records

POST

/crm/v3/objects/{objectType}/batch/upsert

Batch-upsert records by unique property

POST

/crm/v3/objects/{objectType}/merge

Merge two custom object records

Why though Jentic?

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

Credential isolation

HubSpot OAuth 2.0 tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens with custom object permissions — raw client secrets and refresh tokens never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'create a custom object in HubSpot') and Jentic returns matching Custom Objects operations with their input schemas, including required objectType path parameters and property maps.

Time to first call

Direct HubSpot Custom Objects integration: 2-4 days for OAuth flow, schema discovery, and association handling. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Salesforce Shopper Products

Salesforce Commerce Cloud product catalog API for e-commerce scenarios, broader platform but different CRM model

Choose Salesforce when you need commerce-focused product data or are already on the Salesforce ecosystem rather than HubSpot

Alternative

Pipedrive API

Sales-focused CRM with simpler custom fields but no full custom object types

Choose Pipedrive when you need lightweight deal-centric CRM without the complexity of custom object schemas

Alternative

Zoho CRM API

Full CRM with custom modules similar to HubSpot custom objects

Choose Zoho CRM when the customer uses Zoho's ecosystem and needs custom modules with similar flexibility to HubSpot custom objects

Complementary

HubSpot CRM Contacts

Standard contacts API that custom objects frequently associate with

Use alongside Custom Objects when you need to manage the contact records that custom objects associate to

FAQs

Specific to using HubSpot CRM Custom Objects API through Jentic.

Why is there no official OpenAPI spec for HubSpot CRM Custom Objects?

HubSpot does not publish an OpenAPI specification for their Custom Objects API. Jentic generates and maintains this spec so that AI agents and developers can call HubSpot CRM Custom Objects via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the HubSpot CRM Custom Objects API use?

The API uses OAuth 2.0 with scopes specific to CRM object access. Tokens must include the crm.objects.custom.read and crm.objects.custom.write scopes. Through Jentic, OAuth tokens are stored encrypted in the MAXsystem vault and agents receive scoped access without handling refresh flows directly.

Can I batch-upsert custom object records with this API?

Yes. The POST /crm/v3/objects/{objectType}/batch/upsert endpoint accepts up to 100 records per call. Each record is matched by a unique property you specify (such as an external ID), and existing matches are updated while new records are created. This avoids duplicates when syncing from external systems.

How do I search for custom object records through Jentic?

Use Jentic's intent search with a query like 'search custom objects in HubSpot'. Jentic returns the POST /crm/v3/objects/{objectType}/search operation with its input schema. The search endpoint accepts filter groups with property name, operator, and value to return matching records. Install the SDK with pip install jentic to get started.

What are the rate limits for the HubSpot CRM Custom Objects API?

HubSpot applies a burst limit of 100 requests per 10 seconds per OAuth app and a daily limit of 250,000 API calls for Enterprise accounts. Batch endpoints count as a single request regardless of the number of records included, making them more rate-efficient for bulk operations.

Can I associate custom objects with standard HubSpot CRM objects?

Yes. The PUT /crm/v3/objects/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId} endpoint creates associations between any custom object record and contacts, companies, deals, tickets, or other custom objects. Associations are bidirectional and support both default and labeled relationship types.

Do I need a HubSpot Enterprise account to use Custom Objects?

Yes. Custom objects are only available on HubSpot Enterprise plans. Free, Starter, and Professional tiers cannot define or use custom object types. The API requires Enterprise-level OAuth credentials with custom object scopes enabled.