How to get your HubSpot Breeze API usage, balance and spend programmatically

What the HubSpot Breeze API exposes

No billing API, so measure from your side

Argus tracks Breeze as a subscription: plan allotment from the offering, with call volume and 429s from the SDK.

Credential. A HubSpot private app or OAuth token. Argus validates it with GET /account-info/v3/details.

Gotchas

• Credits cost $0.010 each. Past the monthly allotment you buy a capacity pack ($10 per 1,000) or pay as you go.
• Credits don't roll over, and free or view-only seats can't spend them.

How HubSpot Breeze charges

Breeze features debit unified HubSpot Credits at $0.010/credit; monthly allotment then a capacity pack ($10/1,000) or pay-as-you-go. No rollover, no credit-balance API.

At zero. API 429 on rate limit; credits either PAYG-charged or blocked past allotment. Free/view-only seats can't use credits.

• 190 requests per 10s, per org. Daily 250k (Free/Starter) → 1M (Enterprise), shared across private apps.

Or let Argus track it

Paste the key once. Argus keeps the ledger, and your coding agent reads it through the MCP server.

• With the SDK, counts each call and every 429 against the plan's allowance, since there's no meter to read.
• Emails you on low balance, days to zero, a spend spike, or projected overage.
• Hands all of it to your coding agent over MCP, so it can ask what a run cost or how much runway is left without leaving the editor.

> what has hubspot_breeze cost today, and how long until it runs out?

get_overview       → hubspot_breeze: mtd spend, burn per day, days to zero
get_request_costs  { "provider": "hubspot_breeze", "limit": 25 }
get_advisories     → credits_low, spend_spike, rate_limit_low …

Questions

Does HubSpot Breeze have an API for its balance?

HubSpot Credits, which Breeze features spend, have no balance or usage API. They're only visible in the HubSpot UI.

Can I get HubSpot Breeze spend per day from the API?

No. Count calls and price them yourself, or let the Argus SDK do it.

What happens when HubSpot Breeze credits run out?

API 429 on rate limit; credits either PAYG-charged or blocked past allotment. Free/view-only seats can't use credits. Auto-recharge is available.

What key does Argus need for HubSpot Breeze?

A HubSpot private app or OAuth token. Argus validates it with GET /account-info/v3/details.

Related