Quota

Plans can include a quota of a durable resource at no extra cost — tasks, WhatsApp numbers, parallel automations. When your customer goes over the included amount, they’re charged per extra unit. Unlike a usage meter that only counts up, a quota balance rises and falls as customers create and delete.

How it works

Units above the included amount at the start of a period are billed for the full period in advance.

Plan Pro: 15 included tasks, $0.75/extra task
Your customer starts the period holding 25 tasks

Included: 15 tasks (no charge)
Extra:    10 tasks × $0.75 = $7.50 — billed in advance for the full period

Quota rises and falls

The balance moves during the period, but billing follows the high-water mark — the highest quota held during the period. Each increase above the mark is billed from the day of the increase to the end of the period; deleting units never reduces the charge.

Your customer starts the month at 15 tasks.
They create 10 more on day 15 (25 total), then delete them on day 20.

Extra: 10 tasks billed from day 15 to the end of the period
       10 × $0.75 × (15/30) = $3.75

The charge is the same whether they keep the 10 tasks until the end of the period or delete them on day 20. Re-creating units below the high-water mark costs nothing — they’re already billed. These charges land on the next renewal invoice.

What happens when you change the included amount or the price

Changing the included amount or the price per extra unit publishes a new plan version. New customers get it at once. Existing customers keep the included amount and unit price of their version, in both directions, until you move them.

You increase Plan Pro from 15 to 30 included tasks.
Your customer has 25 tasks (paying for 10 extra at $7.50/mo).

Without a move:      still 15 included + 10 extra = $7.50/mo
After you move them: all 25 tasks within the 30 included, $0 extra

You decrease Plan Pro from 30 to 15 included tasks.
Your customer has 25 tasks (all included, $0 extra).

Without a move:      still 30 included, $0 extra
After you move them: 15 included + 10 extra = $7.50/mo

Change	New customers	Existing customers
Raise or lower the included amount	Get the new amount	Keep their version’s amount until moved
Raise or lower the unit price	Pay the new price	Pay their version’s price until moved

A move made now changes the included amount today and the price from the next renewal; a move at renewal changes both then. See Move subscribers.

Quota and upgrades

On an upgrade, your customer is charged the new plan’s full price and credited for the unused days of the old plan’s base price. Extra-unit charges already paid are not credited.

Example

Your customer is on Pro ($29/mo, 15 included tasks, $0.75/extra task).
They have 25 tasks — paying $36.50/mo total (15 included + 10 extra).

They upgrade to Scale ($79/mo, 50 included tasks, $0.50/extra task).
On day 15 of their cycle.

Charge:
  New plan: $79 (full price — the billing cycle restarts today)
  Extra tasks: $0 — their 25 tasks are within the 50 included

Credit:
  Plan base: $29 × (15/30) = $14.50
  Extra tasks: $0 — extra-unit charges already paid are not credited

They pay today: $64.50

Your customer’s 25 tasks are now covered by the Scale plan’s 50 included tasks. They stop paying for extra tasks entirely.

Billing fundamentals

Subscriptions

Consumption and pricing

Payments

How it works

Quota rises and falls

What happens when you change the included amount or the price

Quota and upgrades

Example