HubSpot CRM Custom Objects

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 your Jentic One instance 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.

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

Yes. Because Jentic One is self-hosted, you set the rules that decide which Custom Objects operations your agent can call and which credentials it uses, and HubSpot's per-object custom OAuth scopes mean you grant only the object scopes the agent actually needs. For example, you can allow the agent to search and create records via the search and batch/create endpoints while leaving destructive operations like the merge endpoint out of the allowed set. The OAuth token stays with your own instance and is injected only at execution time, so the agent never sees it directly.