For Agents
Read HubSpot portal metadata and the daily private-app API usage so agents and dashboards can verify the account context and stay within rate limits.
Get started with Account Account Info 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:
"get hubspot account details and api usage"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Account Account Info API.
Retrieve a HubSpot portal's id, currency, time zone, and company name
Determine whether the connected account is a sandbox or production portal
Read the daily API call counts for each private app on the portal
Detect when a private app is approaching its daily call limit
GET STARTED
Use for: I need to verify which HubSpot portal my credential is connected to, Get the time zone and currency configured on the HubSpot account, Check whether the connected HubSpot account is a sandbox, Retrieve the daily private app API usage for portal 1234567
Not supported: Does not modify portal settings, read CRM records, or write any data — use only to read HubSpot portal metadata and private-app daily API usage.
The HubSpot Account Info API exposes account-level metadata and private app API usage for a HubSpot portal. GET /account-info/v3/details returns the portal id, time zone, currency, company name, and whether the account is sandbox, while GET /account-info/v3/api-usage/daily/private-apps returns the day's call counts for each private app on the portal. The endpoints are designed for ops dashboards and quota monitoring rather than data manipulation. Both calls accept an OAuth 2.0 access token or a private app token in the private-app header.
Verify the connected account before running scoped CRM operations
Patterns agents use Account Account Info API for, with concrete tasks.
★ Display the connected portal in an admin UI
When an integration shows which HubSpot account it is currently connected to, GET /account-info/v3/details supplies the portal id, company name, currency, time zone, and sandbox flag in one call. This avoids confusion when a user has access to multiple portals and removes the need to hand-enter portal metadata.
Call GET /account-info/v3/details and render portalId, companyName, timeZone, and accountType in the admin header
Monitor private app daily quota
Private apps on a HubSpot portal share a daily API call limit. GET /account-info/v3/api-usage/daily/private-apps returns the day's call count per private app so a monitoring job can alert when usage crosses a threshold. The response is keyed by private app so multi-app portals can attribute usage accurately.
Call GET /account-info/v3/api-usage/daily/private-apps every hour and emit an alert when any private app's currentUsage exceeds 80% of its dailyLimit
Agent integration via Jentic
An ops agent investigating rate-limit errors can pull current usage and account context in two calls. Through Jentic the agent searches for the account info operations, loads the schemas, and executes them in sequence. The HubSpot credential never leaves the Jentic vault.
Search Jentic for 'get hubspot account details', load GET /account-info/v3/details, then load and execute GET /account-info/v3/api-usage/daily/private-apps to gather full context
2 endpoints — the hubspot account info api exposes account-level metadata and private app api usage for a hubspot portal.
METHOD
PATH
DESCRIPTION
/account-info/v3/details
Retrieve account details for the connected HubSpot portal
/account-info/v3/api-usage/daily/private-apps
Retrieve daily API usage per private app
/account-info/v3/details
Retrieve account details for the connected HubSpot portal
/account-info/v3/api-usage/daily/private-apps
Retrieve daily API usage per private app
Three things that make agents converge on Jentic-routed access.
Credential isolation
OAuth access tokens and private app tokens are stored encrypted in the Jentic vault. Agents call /account-info/v3 endpoints through scoped session tokens — the raw HubSpot credential never enters the agent's context.
Intent-based discovery
Agents search Jentic with intents like 'check hubspot private app daily api usage' and Jentic returns GET /account-info/v3/api-usage/daily/private-apps with its input schema, ready to execute.
Time to first call
Direct integration: an hour or two to wire OAuth and parse the responses. Through Jentic: under 15 minutes — search, load, execute against the two read endpoints.
Alternatives and complements available in the Jentic catalogue.
HubSpot Audit Logs
Audit Logs returns login activity and security history for the same portal
Use after Account Info to investigate who did what on the portal
HubSpot OAuth
OAuth endpoints return token metadata and refresh access tokens used here
Use to inspect or refresh the access token before calling Account Info
HubSpot Auth API
Equivalent OAuth and account introspection endpoints under hubapi.com
Choose this when the integration is built against the hubapi.com vendor namespace
Specific to using Account Account Info API through Jentic.
What authentication does the HubSpot Account Info API use?
The spec lists two security schemes: OAuth 2.0 access tokens and a private app token sent in the private-app header. Either credential type can call both endpoints. Through Jentic the credential is stored encrypted in the vault and the agent receives only a scoped session token.
Can I tell if a HubSpot account is a sandbox with this API?
Yes. The response from GET /account-info/v3/details includes an accountType field that distinguishes between standard, sandbox, and developer test accounts, so an integration can branch on environment without hardcoding portal ids.
What are the rate limits for the HubSpot Account Info API?
The spec does not declare a per-endpoint limit. Account Info calls count against the standard HubSpot per-account limit of around 100 requests per 10 seconds for OAuth and private apps, plus the daily call cap surfaced by the private-apps usage endpoint itself.
How do I check daily API usage for a private app through Jentic?
Search Jentic for 'check hubspot private app daily api usage', load the schema for GET /account-info/v3/api-usage/daily/private-apps, and execute it. Jentic returns the JSON list with per-private-app currentUsage and dailyLimit values.
Does this API expose CRM data such as contacts or deals?
No. Account Info is read-only metadata about the portal and its API usage. Use the HubSpot CRM API for contacts, companies, deals, and other CRM objects.