Pricing reference

Every unit OXYGEN charges for, generated from the constants the billing code reads. Prices that exist in code but sit behind a feature flag that is off by default are listed under Built, not currently charged rather than shown as live prices; per-operation provider prices are resolved per descriptor and are read with oxygen tools get <tool-id> --json.

What a credit is worth

Plans

Included credits are face value ($1 = 100 credits) plus the plan's volume bonus, which is already counted in the column. An existing subscriber to a bonus plan receives the bonus from their next renewal. A yearly plan (2026-09 repricing) costs 10 months' price and still grants its included credits monthly; it is sold once yearly billing is switched on, and until then a yearly request is refused with annual_billing_unavailable (yearly billing).

Trial, grants, and grace

Credit top-ups

A custom top-up runs from 800 credits to 100,000 credits in steps of 100. Purchased credits stack like plan grants and do not expire.

From the 2026-09 repricing's effective date a top-up costs $1.30 per 100 credits and these packs are sold instead; oxygen billing topup --json reports the rate and packs in force, and the ones scheduled once the date is set.

AI columns, Copilot, and Agents

Copilot and Agent turns bill managed inference against the same credit balance, inside the session or run budget approved when they start. On a BYOK model credential the provider bills you directly and OXYGEN charges no credits.

Enrichment and research

These are the sheet's typical values. The price that actually bills is the one on the operation descriptor, which varies by provider and request shape — read it with oxygen tools get <tool-id> --json, or preview the exact request with a dry run before spending.

Email infrastructure

Sending seats

Connecting a sender occupies a sending seat. Seats are sold in dollars on their own subscription — separate from the plan and from credits — and the gate that enforces them (OXYGEN_SENDING_SEAT_GATE_ENABLED) is armed in production: the senders a workspace already had when the gate was armed are grandfathered, and every further sender needs a purchased seat. oxygen billing seats --json reports the price, what is purchased, what is grandfathered, what is connected, and what is left.

Seats belong to the billing owner. A workspace linked to another organization's plan with oxygen orgs billing-link connects senders against that organization's seats and buys them there — oxygen billing seats set inside a linked workspace is refused with shared_billing. An OXYGEN-sold managed mailbox already includes its seat; the email seat above is for a mailbox you bring yourself.

LinkedIn and WhatsApp

LinkedIn and WhatsApp are priced as pure connected-account seats (above): every individual action is 0 credits, so a sequence's LinkedIn steps never draw against its credit cap.

Voice

Voice settles on the telephony provider's status webhook after the call ends. A connected call bills its talk time, with a started minute counted as a whole one; a call nobody answered costs nothing. There is no separate per-call charge. A rented phone number is priced under connected-account reservations.

Connected-account reservations

From the 2026-09 repricing, every connected account reserves its monthly credits from the balance on its own monthly anchor instead of occupying a dollar sending seat. The new prices take effect on the repricing's effective date; until then the price in force is the one in the second column. oxygen billing commitments --json shows what a workspace reserves today.

Workflow automation

From the 2026-09 repricing date a provider call on your own API key pays a 0.05-credit platform fee, settled in aggregate like workflow steps. AI calls on your own model key are not charged this fee.

Built, not currently charged

These prices exist in code behind a feature flag that is off unless explicitly set. Each reader requires the environment variable to be exactly true, so an unset or malformed value means no reservation and no charge.

Connected LinkedIn accounts and WhatsApp numbers are charged today as the dollar-priced sending seats above, not through these credit rows. Managed mailboxes, warmup, and inbox-placement monitoring are sold today as recurring subscriptions carrying the prices listed above; the credit-commitment rail and the legacy credit seat rail are second, currently dark mechanisms for the same resources — oxygen billing commitments may list them as tracked, but they are never an additional charge on top of a seat or a subscription.

Default spend ceilings

Spend defaults scale with plan size. An autonomous trigger or table auto-run armed without an explicit cap is backstopped by its plan's default, resolved when it fires; an explicit cap always wins.

The delivery default is 10% of the plan's monthly credits (50 on free). Grandfathered plans take 10% of their own monthly credits: Starter 990 (otherwise the Oxygen $99 column), Pro 2,490 (otherwise the Oxygen $199 column), Team 7,490 (otherwise the Oxygen $999 column). Legacy scale plans read the Oxygen $1,999 column, and enterprise plans have no default. oxygen limits show names your plan size and returns every size's values under plan_bands; the web app shows the same values under Settings → Plan limits.

An Agent run may spend up to the smaller of its approved max_credits and the Agent run ceiling above. That ceiling is a default: one run or trigger may carry a higher max_credits when you approve it explicitly (--approve-above-default, or the card in the web app), up to 25,000 credits, and an enterprise contract can set its own default. The Copilot allowance covers paid work up to its per-call and per-session amounts without an approval card; sends, launches and other external writes always ask, at any price, and one attended Copilot turn is bounded at 3,000 credits on every plan. A dash means no default. The daily spend guard is a runaway backstop, not a spend ceiling: on paid plans it warns at 5x and hard-blocks at 20x the plan's monthly credits spent in one day, monthly reservations and managed mailbox subscriptions do not count toward it, and your own org daily budget replaces it. Run oxygen limits show or oxygen budget list to see the exact credit thresholds for your plan. BYOK daily call caps are monitoring thresholds and warn rather than stop a run unless OXYGEN_BYOK_DAILY_CAPS is set to enforce.

API rate limits

Request rates scale with plan size. Every /api/cli/* call counts against a per-key and a per-workspace total a minute; the operation limits below apply first to the calls a script makes most. Limits guard against runaway loops: they are never sold and never billed.

Windows are fixed: a per-minute limit resets at the start of each minute, an hourly one at the start of each hour. A request over a limit is refused with HTTP 429 and rate_limit_exceeded; wait the seconds in the Retry-After header (also error.details.retry_after_seconds) before retrying. error.details.bucket names the limit that was hit, error.details.limits_url opens the web app's Plan limits page with every plan size's rates, and the CLI exits with code 6. Live AI calls and live tool calls are separate buckets with the same limits. A row budget counts one unit per row a request reads or writes, shared by every key in the workspace; a single-row request still counts toward it but is never refused by it, only by the per-minute rates. Bulk work belongs in a durable table run, which these per-request limits do not pace. oxygen limits show --json returns your plan's rates under api_rate_limits and every plan size's under plan_bands.

Webhook ingress

Inbound webhooks accept more deliveries a minute on bigger plans. The limit applies to each target on its own: a Table webhook endpoint, a workflow or Agent webhook trigger, and the workspace's RB2B receiver. The target and the sender IP are counted separately, and one sender IP may use the whole per-target rate, so a form tool or CRM posting from one address is not held to less. A second endpoint has its own allowance. A delivery counts once however many rows it carries.

Windows are fixed and reset at the start of each minute. A delivery over the limit gets HTTP 429 with a Retry-After header; redeliver after that many seconds. Nothing is written for a refused delivery, so a sender that retries loses nothing. For a steady flow above your plan's rate, batch several rows into one delivery with --items-path on oxygen tables webhook create; a delivery may be up to 1 MB of JSON. A refused delivery is not recorded in oxygen tables webhook deliveries. oxygen limits show --json returns your plan's rate under webhook_ingress, the tables webhook commands report the endpoint's under rate_limit, and a workflow or Agent webhook trigger reports its own under rate_limit in oxygen workflows get, oxygen workflows apply, oxygen agent trigger-create and oxygen agent triggers.

Table and signal limits

Storage, import size, columns per auto-run and the signals feed scale with plan size too. Like the rates above they are guards, never sold and never billed.

CSV and JSONL files stream, so they import up to the file size above. JSON and XLSX files are read whole, so on every plan they stop at 100 MiB; save a larger file as CSV or JSONL. Rows per Table still cap how many rows one import can load.

A request over one of these is refused with an error that names the limit. oxygen limits show --json returns every plan size's values under plan_bands.

Ledger categories

Every credit ledger entry carries one of these 19 categories. oxygen billing usage --json returns them.

Ledger transaction types

What costs nothing