HubSpot Account Account Info
Browse all HubSpot APIs✓ Official Vendor SpecDeveloper ToolsMonitoring Observabilityoauth2, apiKey2 EndpointsREST
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.
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.
Install Jentic One Beta
Connect the Account Account Info to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Account Account Info, 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 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
Verify the connected account before running scoped CRM operations
Use Cases
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
Key Endpoints
2 endpoints — the hubspot account info api exposes account-level metadata and private app api usage for a hubspot portal.
METHOD
PATH
DESCRIPTION
GET
/account-info/v3/details
Retrieve account details for the connected HubSpot portal
GET
/account-info/v3/api-usage/daily/private-apps
Retrieve daily API usage per private app
GET
/account-info/v3/details
Retrieve account details for the connected HubSpot portal
GET
/account-info/v3/api-usage/daily/private-apps
Retrieve daily API usage per private app
Why Jentic?
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.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
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.
GET STARTED