Email inbox

Auto-pull invoices from Gmail. Sync runs read-only — Budget never sends or modifies your mail.

Gmail OAuth is not configured.

  1. Open Google Cloud Console → Credentials.
  2. Enable the Gmail API on the project.
  3. Create an OAuth 2.0 Client ID (type: Web application).
  4. Add this redirect URI: https://budget.benheath.cc/api/integrations/gmail/callback
  5. Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in .env.local and restart.

Connected mailboxes

Heath Media addresses scanned for incoming invoices

tom@heathmedia.co.uk
Tom — primary
Not connected Connect
content@heathmedia.co.uk
Content team
Not connected Connect

Cron sync

Set up a periodic sync from your VPS or any scheduler.

Set CRON_SECRET in .env.local, then call:

curl -X POST -H "X-Cron-Secret: $CRON_SECRET" https://budget.benheath.cc/api/integrations/gmail/sync

Recommended cadence: every 15 minutes during business hours.