HubSpot CRM Limits Tracking
Browse all Hubspot APIs✓ Official Vendor SpecCRMContact Managementoauth29 EndpointsREST
For Agents
Read the live structural limits and current usage of a HubSpot CRM portal — record counts, custom objects, properties, pipelines, and association labels.
Use for: Check whether the portal has room for another 50,000 contact records, I need to know how many custom properties are left on the deals object, Find out if the portal can accept a new custom object type, Get the maximum number of pipelines allowed on the deals object
Not supported: Does not handle API request rate limits, billing usage, or limit upgrades — use for reading structural CRM portal quotas only.
The HubSpot CRM Limits Tracking API exposes the per-account quota information for the structural pieces of a HubSpot CRM portal — record counts, custom object types, custom properties, calculated properties, pipelines, and association labels. Each endpoint returns a current count, a maximum, and the remaining headroom so an integration or agent can check whether a planned action will exceed the account's plan limits before attempting it. It is the right tool for portal health checks, onboarding readiness validation, and pre-flight checks ahead of bulk imports or schema changes.
Install Jentic One Beta
Connect the CRM Limits Tracking to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the CRM Limits Tracking, 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.
1
Step 1: 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 | sh2
Step 2: 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 instanceJentic 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 CRM Limits Tracking API.
Read the current record count and maximum for each standard and custom object in the portal
Check how many custom object types and custom properties are still available before hitting the plan cap
Inspect calculation property limits and remaining headroom across the portal
Read pipeline limits per object to verify that a new pipeline can be created
Read record-association limits between two object types to confirm an association is permitted
Use Cases
Patterns agents use CRM Limits Tracking API for, with concrete tasks.
★ Pre-Flight Check Before a Bulk Import
Before triggering a large import or migration into HubSpot, query the limits API to confirm the destination object has enough record headroom and the schema has enough custom-property slots for the incoming columns. The endpoint returns current count, maximum, and remaining slots in one response, which lets an agent or migration runner abort cleanly before consuming an import slot.
Call GET /crm/v3/limits/records and GET /crm/v3/limits/custom-properties, parse the remaining values for the contacts object, and abort if either is below the count of incoming records or columns.
Portal Health Dashboard
Surface a portal-level health view that highlights when any structural limit is approaching its cap so an admin can plan a cleanup or schema redesign. The limits endpoints return uniform shapes across object types, which makes a single dashboard query straightforward to build. Typical alert thresholds are 80% and 95% of the maximum.
Call GET /crm/v3/limits/records, GET /crm/v3/limits/custom-object-types, and GET /crm/v3/limits/pipelines, compute usage as current divided by maximum for each, and emit an alert when any value exceeds 0.8.
Agent-Driven Schema-Change Safety Check
An AI agent that proposes schema changes (a new custom object, a new pipeline, a new association label) can call the limits API as a guardrail before the change request, refusing to attempt a creation that would exceed the cap. Through Jentic, the agent finds the relevant limits endpoint by intent and chains it with the create call from the corresponding schema or pipeline API.
Before calling a pipeline-create operation, GET /crm/v3/limits/pipelines for the target object and refuse to proceed if remaining is zero, returning a structured warning to the user.
Key Endpoints
9 endpoints — the hubspot crm limits tracking api exposes the per-account quota information for the structural pieces of a hubspot crm portal — record counts, custom object types, custom properties, calculated properties, pipelines, and association labels.
METHOD
PATH
DESCRIPTION
GET
/crm/v3/limits/records
Read record limits for each object type
GET
/crm/v3/limits/custom-object-types
Read custom object type limits
GET
/crm/v3/limits/custom-properties
Read custom property limits
GET
/crm/v3/limits/calculated-properties
Read calculation property limits
GET
/crm/v3/limits/pipelines
Read pipeline limits per object
GET
/crm/v3/limits/associations/labels
Read association label limits
GET
/crm/v3/limits/records
Read record limits for each object type
GET
/crm/v3/limits/custom-object-types
Read custom object type limits
GET
/crm/v3/limits/custom-properties
Read custom property limits
GET
/crm/v3/limits/calculated-properties
Read calculation property limits
GET
/crm/v3/limits/pipelines
Read pipeline limits per object
GET
/crm/v3/limits/associations/labels
Read association label limits
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
HubSpot OAuth and Private App tokens are stored encrypted in the Jentic vault. Agents receive scoped access references, never raw tokens.
Intent-based discovery
Agents search by intent (e.g., 'check HubSpot record limits') and Jentic returns the matching limits endpoint with its full response schema.
Time to first call
Direct integration: a few hours to handle the six different limit endpoints. Through Jentic: under 15 minutes — the schema is loaded on demand.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using CRM Limits Tracking API through Jentic.
What authentication does the HubSpot CRM Limits Tracking API use?
OAuth 2.0 Bearer tokens or HubSpot Private App tokens in the Authorization header. Jentic stores the token encrypted in the vault and the agent receives a scoped access reference, never the raw secret.
Can I see how many contact records are left before hitting the plan limit?
Yes. GET /crm/v3/limits/records returns an array of object-level entries, each with currentCount and limit, so you can compute remaining headroom for contacts, companies, deals, and any other CRM object in the portal.
What are the rate limits for this API?
Standard HubSpot account-wide limits apply: 100 requests per 10 seconds for OAuth apps and 110 for Private Apps, with daily caps that vary by Hub subscription. The limits endpoints are read-only and cheap to call, so caching the response for a few minutes is usually sufficient for dashboards.
How do I check pipeline limits before creating a new pipeline through Jentic?
Run pip install jentic, call client.search('check HubSpot pipeline limits'), client.load to get the schema for GET /crm/v3/limits/pipelines, and client.execute. The response gives the maximum and current count per object type so a create call can be guarded against exceeding the cap.
Does this API let me change a portal's limits?
No. The endpoints are read-only and reflect the limits assigned by the HubSpot subscription tier. Raising a cap requires a plan upgrade through HubSpot account management, not an API call.
Where can I see association limits between two object types?
GET /crm/v3/limits/associations/records/{fromObjectTypeId}/{toObjectTypeId} returns the maximum number of associations permitted between records of the two given object types, plus current usage on a sample query basis.
GET STARTED