Hosting · Integration · New in 0.9.0

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

About 3 minBilled

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

Open Heroku's key page ↗

  1. Install the Heroku CLI and run heroku login.
  2. Run: heroku authorizations:create --description Burnstack --scope identity,read --expires-in 7776000
  3. Copy the token it prints (HRKU-…).
  4. 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.
Burnstack Connectors, Add cost source tab: a search box, category filters and one card per vendor with its key steps

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?
Authorizations created in the Heroku dashboard have global scope, which can change your apps. The CLI can create one with only the read-only identity and read scopes, which is all Burnstack needs.
Can I still import Heroku invoices?
Yes, through the Imports page as before, and nothing counts until you approve it. The review queue warns you when an import covers days the Heroku connection already reports.

Start watching back.

Five minutes to connect your first vendor. Free for Mac, forever, and every byte stays yours.