Heroku cost tracking: monthly invoices, personal or team
See what Heroku bills you each month, spread over its days, next to your hosting, database and AI costs.
What Burnstack tracks
- Your Heroku invoices from the Platform API (Heroku docs), each total spread evenly over the days of its period: what you were billed
- Your own account's invoices, or a team's
- Every invoice on the first sync
Alerts
- Spike alerts can't see Heroku: amounts are monthly and spread evenly, so a jump shows up as a higher daily average once the month's invoice exists.
The key you'll need
An authorization token with only the identity and read scopes, made with the Heroku CLI: heroku authorizations:create --description Burnstack --scope identity,read --expires-in 7776000 (90 days). Both scopes are read-only (Heroku docs). Authorizations made on the dashboard's Applications page have global (read and write) scope, so use the CLI; that page is where you list and revoke them. For a team's invoices, paste TEAM_NAME:TOKEN; your role in the team must be able to see its invoices.
Burnstack checks the key with Heroku, shows the account it belongs to when Heroku lets the key see it, and stores it in your computer's keychain (macOS Keychain or Windows Credential Manager). It only reads billing and usage.
Connect it: Heroku
Need
- Key: Authorization token (identity, read)
- Plan: Any account; a team's invoices need a role that can see them.
- Permissions: Scopes: identity, read (both read-only) not yet verified
Create a read-only token with the Heroku CLI: heroku authorizations:create --description Burnstack --scope identity,read --expires-in 7776000, and paste the token it prints. For a team's invoices, paste TEAM_NAME:TOKEN (your role must see the team's invoices). Authorizations made in the dashboard have global scope, so use the CLI. Burnstack reads your monthly invoices and spreads each over its month; the current month appears once Heroku issues its invoice.
Steps
- Install the Heroku CLI and run heroku login.
- Run: heroku authorizations:create --description Burnstack --scope identity,read --expires-in 7776000
- Copy the token it prints (HRKU-…).
- Paste it into Burnstack; for a team's invoices, paste TEAM_NAME:TOKEN.
Paste it
In Burnstack: Connectors → Heroku → Add key → paste → Validate & save. The key goes straight into your computer's keychain.
If it fails
- Heroku API error 401
- The token was revoked, expired or mistyped. Create a new one with the CLI command.
- The token needs the identity and read scopes not yet verified
- Create the token with --scope identity,read. For a team, your role must be able to see its invoices.
Let your AI do the clicking not yet verified
Paste this into an AI assistant that can use your browser, such as Claude in Chrome. It opens Heroku's key page and sets only the permissions above, then stops before the final button that creates the key.
Open https://dashboard.heroku.com/account/applications in my browser. This page lists Heroku authorizations, but its form creates one with global scope, so don't use it: tell me to run heroku authorizations:create --description Burnstack --scope identity,read --expires-in 7776000 in a terminal instead. Heroku has no expiry setting for this token, so skip that. Stop before clicking 'Create authorization' (the final button that creates the token) and tell me it's ready. I'll click it, copy the token and paste it into Burnstack myself. Don't copy, read or paste the token, and don't grant broader access or change any other setting. If Heroku asks me to sign in or confirm with 2FA, wait for me.
The key never passes through the AI: you click that last button yourself, copy the key and paste it into Burnstack.
What you'll see
- Billed: Billed cost, as Heroku charges it.
- History: All invoices.
- Delay: Monthly: an invoice appears after its month closes.
Good to know
- Monthly only: the current month has nothing until Heroku issues its invoice after the month closes.
- No split by app, dyno or add-on: each invoice total goes to the account or team.
- The token expires after the 90 days the command asks for. Create a new one and paste it; until then the stale-data alert tells you syncs are failing.
- Not yet checked against a live account: Heroku's reference gives personal invoice amounts in dollars and team amounts in cents, and Burnstack reads them that way. Compare one month with the invoice in your Heroku dashboard.
One bill, not a dashboard per vendor
Burnstack puts Heroku next to the rest of your spend and lets you group it by product with applications. Other integrations: Vercel, Neon, Supabase, OpenAI, Anthropic, GitHub, OpenRouter, DigitalOcean, Twilio, Stripe fees, Cloudflare, Netlify, AWS, Datadog, Sentry, Cursor, PlanetScale, Azure, Google Cloud, MongoDB Atlas, Railway, Render, Akamai (Linode), Vultr, Fastly, Runpod, xAI, Together AI, fal.ai, Runway, Upstash.
Heroku questions
Why does Burnstack need the Heroku CLI?
Can I still import Heroku invoices?
Start watching back.
Five minutes to connect your first vendor. Free for Mac, forever, and every byte stays yours.