HubSpot CRM Limits Tracking
Browse all Hubspot APIsOfficial vendor OpenAPI document · agent-readyCRMContact 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fhubspot.com%2Fhubspot-crm-limits-tracking" | sh2
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%2Fhubspot.com%2Fhubspot-crm-limits-tracking" | 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?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring HubSpot CRM Limits Tracking by hand means implementing its OAuth2 authorization-code flow (or managing a private-app token), routing read calls to api.hubapi.com, and parsing each quota response yourself. Through Jentic you install once, import HubSpot CRM Limits Tracking from the API Directory, store the token once, and your agent calls it.
Permission scoping
These endpoints are read-only quota lookups such as /crm/v3/limits/records and /crm/v3/limits/pipelines. Limit the agent to the operations it needs, such as reading record and property limits, so it only queries the quotas you intend and nothing more.
Credential isolation
Your HubSpot token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'check HubSpot record limits' or 'read custom object quotas', and Jentic returns the matching limits endpoint with its response schema so the agent calls the right endpoint without browsing the reference docs.
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.
Can I limit what my agent is allowed to do with the HubSpot CRM Limits Tracking API?
Yes. Because you run Jentic One yourself, your own rules decide which of these read-only quota operations the agent may call, so you can allow only what a given task needs. For example, you can permit GET /crm/v3/limits/records and GET /crm/v3/limits/custom-properties for a pre-import check while withholding GET /crm/v3/limits/pipelines or the association-label lookup. Your HubSpot token is stored once by your own instance and injected at execution time, so the agent queries only the quotas you intend and never sees the raw secret.
GET STARTED