Billing

Stripe is optional. Without it, teams stay on the free plan or operator-assigned tiers.

Plans

PlanRate limitActive inboxesEmails/monthHow
free60/min10500Get a free key
pro, $29/month300/min1005000Upgrade or operator
enterprise600/min500no capOperator, Dedicated Resend
legacy120/min500no capSingle wrangler API_KEY

Without Stripe (today)

npm run issue:key:db -- pilot-name
# free plan · dashboard works · no Upgrade button

Manual pro: operator runs npm run team:plan -- TEAM_ID pro.

With Stripe (Pro self-serve)

  1. Stripe product + recurring price → STRIPE_PRICE_PRO
  2. Webhook POST /webhooks/stripe (see events below)
  3. Worker secrets: STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, STRIPE_PRICE_PRO
npm run wizard:stripe
npm run wizard:stripe -- --deploy
npm run doctor:billing

Operator guide: STRIPE-SETUP.md

API

GET  /v1/me                    → billing.stripeEnabled, canUpgrade
POST /v1/billing/checkout      → { url }  (admin scope, free plan)
POST /v1/billing/portal        → { url }  (existing Stripe customer)

GET  /v1/upgrade/config        → { billing }  (public)
POST /v1/upgrade/request       → emails a one-time link { email, action: checkout | portal }
POST /v1/upgrade/confirm       → { url }  (token from the link)

Emails per month count outbound sends and inbound messages. Over the cap the API returns 429 monthly_quota_exceeded.

Dashboard — Upgrade / Manage billing when Stripe is enabled.

Webhook events

Enterprise

Not sold via Stripe checkout yet — contact hello@webmailagent.com or operator npm run team:plan -- TEAM_ID enterprise.