Provider Sync
Vercel Provider Sync
Sync Vercel team billing charges to a variable expense.
Connect Vercel to auto-fill monthly actuals from your team's billing API.
Credentials
| Field | Where to find it |
|---|---|
| Team ID | Vercel dashboard → Team Settings → team_xxx |
| Access token | Vercel account → Tokens → create with billing read scope |
API
GET https://api.vercel.com/v1/billing/charges?teamId={id}&from={iso}&to={iso}
Returns FOCUS v1.3 NDJSON. Recurex sums BilledCost rows (excludes Credit rows) for the calendar month.
Setup
- Create or edit a variable expense in USD (e.g. "Vercel Pro")
- Open Actuals → Connect provider → Vercel
- Enter Team ID and access token
- Recurex validates with a live charges call for the current month
- Click Sync now or wait for the monthly cron
Billing cycle
Calendar month UTC. The cron on the 2nd syncs the previous month.
Troubleshooting
| Error | Fix |
|---|---|
| Invalid token | Regenerate with billing read permissions |
| Wrong team | Verify Team ID matches the billed team |
| Currency mismatch | Expense must be USD |
| Zero amount | Current month may be incomplete — wait for month end or use manual actuals |