Spending notifications

About spending notifications

Spending notifications help you keep track of your organization's Neon spending. When charges approach the threshold you set, organization admins receive email alerts so they can take action before the bill grows further.

Spending notifications are available on the Launch and Scale plans. You can manage them from the Billing page in the Neon Console or with the Neon Management API.

Who can set up spending notifications

Only organization admins can enable, edit, or disable spending notifications. Other members see the notification threshold in read-only form on the Billing page.

Alert thresholds

When a spending notification is configured, Neon sends email alerts to organization admins at two thresholds:

• When spending reaches 80% of the threshold
• When spending reaches 100% of the threshold

Neon checks your spending every 15 minutes. Once spending crosses a threshold, an alert email goes out, and reminders continue weekly until you raise the threshold or the billing cycle resets.

Enable spending notifications

1. Navigate to the Neon Console.
2. Select your organization from the breadcrumb menu at the top-left.
3. Select Billing from the menu.
4. On the Spending Notifications card, select Enable.
5. In the Enable Spending Notifications dialog, enter a whole-dollar amount.
6. Select Enable.

The Spending Notifications card now shows the current spending and a progress bar toward the threshold.

Edit the threshold

1. Navigate to the Billing page.
2. On the Spending Notifications card, select Edit.
3. Update the amount and select Save.

You can also open the edit dialog from the over-threshold banner by selecting Manage spending notifications. The banner appears in the Console when spending is approaching the threshold or has reached it.

Disable spending notifications

1. Navigate to the Billing page.
2. On the Spending Notifications card, select Disable.
3. Confirm in the Disable Spending Notifications dialog.

After you disable notifications, no further email alerts are sent and the over-threshold banner no longer appears.

What happens when the threshold is reached

When your organization's monthly charges reach the threshold:

• Admins receive a final email alert.
• A banner appears in the Neon Console showing Threshold reached, with a Manage spending notifications link that opens the edit dialog.

Projects continue to run, and charges continue to accumulate, until you raise the threshold or the billing cycle resets at the start of the next month. Automatic project suspension is coming soon and will stop compute charges at the threshold.

Spending notifications only send alerts; they don't stop usage. If you need Neon to actively suspend computes when a limit is reached, you can set per-project consumption quotas with the Neon API. These work per project and per consumption metric (compute, storage, and data transfer) rather than on total dollar spend. See Configure consumption limits.

Manage spending notifications with the Neon API

You can manage spending notifications through the Management API at:

https://console.neon.tech/api/v2/organizations/{org_id}/billing/spending_limit

Replace {org_id} with your organization ID (see Finding your org_id). Authenticate with a personal API key or another allowed credential for the Management API.

Request body (PUT): send spending_limit_cents as a positive integer (monthly threshold in cents; minimum 1). For example, $100.00 per month is 10000. Values 0 and null are rejected; to clear a threshold, call DELETE on the same path (idempotent when no threshold is configured).

Response (GET / PUT 200): the API returns spending_limit_cents, or null when no threshold is set. Alerts at 80% and 100% of the threshold behave the same as for Console-managed notifications; computes are not suspended by this feature.

See the linked API reference pages for response codes, schemas, and Try it examples.