Plans & Billing

Manage your subscription plan, view usage, and handle upgrades and downgrades via the API.

PushMail offers five plans: Free, Starter, Growth, Business, and Enterprise. Every plan includes API access and pay-per-email pricing with volume discounts. Paid plans add a monthly base price with included email sends and lower overage rates.

Plans overview

Plan	Monthly Price	Included Emails	Max Sites	Max Contacts/Site	Max Sequences
Free	$0	Pay-per-email	1	1,000	2
Starter	$29	10,000	3	10,000	10
Growth	$79	50,000	10	50,000	50
Business	$199	200,000	50	250,000	200
Enterprise	$499	1,000,000	Unlimited	Unlimited	Unlimited

API Endpoints

Plan Management

GET

/plans

List all available plans with features and pricing

GET

/plans/current

Get your organization's current plan, usage, and billing period

POST

/plans/change

Preview or apply a plan upgrade/downgrade with proration

POST

/plans/cancel

Cancel your subscription (runs until period end)

GET

/plans/usage

Get current period usage vs plan limits

List all plans

curl https://pushmail.dev/api/v1/plans \
  -H "Authorization: Bearer pm_live_YOUR_KEY"

Returns an array of all plans with their pricing, included sends, overage tiers, and feature limits.

Get current plan

curl https://pushmail.dev/api/v1/plans/current \
  -H "Authorization: Bearer pm_live_YOUR_KEY"

Returns your organization's active plan, current usage, credit balance, and billing period dates.

Upgrade or downgrade

Plan changes are handled in two steps:

Step 1: Preview

curl -X POST https://pushmail.dev/api/v1/plans/change \
  -H "Authorization: Bearer pm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"planId": "growth", "confirmProration": false}'

Returns a proration breakdown showing credits for unused time on the current plan, charges for the new plan, and the net amount.

Step 2: Confirm

curl -X POST https://pushmail.dev/api/v1/plans/change \
  -H "Authorization: Bearer pm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"planId": "growth", "confirmProration": true}'

Applies the plan change immediately. The net proration amount is deducted from (or credited to) your balance.

Downgrade restrictions

When downgrading, the API checks your current resource usage against the new plan's limits. If you exceed any limit, the change is blocked with a list of specific blockers (e.g., "You have 5 sites but the Starter plan allows 3").

Cancel subscription

curl -X POST https://pushmail.dev/api/v1/plans/cancel \
  -H "Authorization: Bearer pm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"confirm": true}'

Cancellation is scheduled for the end of your current billing period. Your plan remains active until then, after which your account reverts to the free plan.

Check usage

curl https://pushmail.dev/api/v1/plans/usage \
  -H "Authorization: Bearer pm_live_YOUR_KEY"

Returns current usage across all resource categories (emails, sites, contacts, sequences, team members) compared to your plan limits, including overage calculations.

Proration

When changing plans mid-cycle, PushMail calculates proration based on remaining days:

Credit for unused days on your current plan
Charge for remaining days on the new plan
Net amount = charge minus credit

The net amount is applied to your credit balance. If it's a credit (downgrade), your balance increases. If it's a charge (upgrade), your balance decreases.

Free plan

New accounts start on the free plan with $5.00 in credits. On the free plan, emails are charged at the standard pay-per-email rates from your credit balance. There is no monthly fee, but resource limits are more restrictive.

Plan Management

On this page