Vercel
Track bandwidth, build minutes, and function invocations
Stackwatch tracks your Vercel bandwidth, build minutes, and function invocations against your plan's limits, with per-project deployment breakdowns on Pro.
Requirements
- A Vercel account on the Pro or Team plan. The Vercel billing API is not available on Hobby accounts — if you connect a Hobby account, the integration will show an "unsupported" status.
- A Vercel API Token with access to your account's billing data.
Step 1 — Create a Vercel API Token
- Go to vercel.com/account/tokens
- Click Create
- Give it a name, e.g.
stackwatch - Set the scope to Full Account (required to read billing/usage data)
- Set an expiry (no expiry is fine for long-term monitoring, but rotation is good practice)
- Click Create Token and copy it — it's only shown once
Step 2 — Add the integration in Stackwatch
- Navigate to your project in the Stackwatch dashboard
- Go to the project's Integrations tab
- Find Vercel and click Add account
- Paste your token into the API Token field
- Give the integration a label (e.g.
vercel-prod) - Click Connect
What gets tracked
Free tier
| Metric | Description |
|---|---|
| Bandwidth | Data transferred vs your plan's monthly bandwidth limit (GB) |
| Build minutes | Total build execution time vs monthly limit |
| Function invocations | Serverless function executions vs monthly limit |
Pro tier (additional)
| Metric | Description |
|---|---|
| Edge function execution | Edge function execution time (ms) vs limit |
| Image optimizations | Optimized images served vs monthly limit |
| Analytics events | Analytics events recorded vs limit |
| Deployments | Total deployments this month vs account limit |
| Per-project deployments | Deployment count broken down per project for the current month |
Troubleshooting
"Invalid or expired API token" The token was revoked or expired. Generate a new one and reconnect from the project's Integrations tab.
"Token lacks billing read permissions" The token scope doesn't cover billing data. Make sure you selected Full Account scope when creating it. Team-scoped tokens for a specific team may not have access to account-level billing.
"Hobby plan accounts are not supported" The Vercel billing/usage API is only available on Pro and Team plans. You'll need to upgrade your Vercel plan to use this integration.
Metrics show 0 or aren't updating Vercel's usage API updates periodically, not in real time. If you've just started a billing period or had very little activity, values may be 0. Check back after your next Stackwatch poll cycle.
Token rotation
- Create a new token at vercel.com/account/tokens
- In Stackwatch, go to Integrations, find your Vercel integration, and click the edit (pencil) icon
- Paste the new token and save