Skip to main content
Billing notifications tell you when your credit consumption crosses a threshold you’ve set for a project or for your whole account. You define the thresholds on the Budgets and alerts page, then choose how you want to be notified—by email, Slack, or webhook—from the Billing tab of the Notifications page. Only Billing Admins and Super Admins can access the Billing tab.
Billing notifications are for information only. They don’t affect your pipelines, jobs, or Maia—a notification simply tells you that credit usage has crossed a threshold.

​
How billing notifications work

Billing notifications are generated from the budgets and thresholds you configure on the Budgets and alerts page. Each project—and the account budget—has a single entry on the Billing tab of the Notifications page, where you add the delivery channels for it. That single entry covers both the annual and monthly periods for its scope, so you don’t need a separate notification for each period. Configure a budget with thresholds on the Budgets and alerts page first. Only scopes—the account, or a project—that already have a budget configured appear when you add a notification here.
Delivery channels are per-user. Seeing an entry on the Billing tab doesn’t mean you’ll be notified—you receive a notification only through the delivery channels you add for yourself. When one user adds a channel, only that user is notified. Any other user who wants the alerts sees the same entry with a dash in the Delivery column and must add their own delivery channels to receive it.The exception is the account’s annual Warning and Critical threshold alerts and the overage alert, which Maia always emails to all Billing Admins and Super Admins, regardless of their individual delivery settings.
Budgets are set at two levels:
  • Account: Tracks total credit consumption across every project.
  • Project: Sets a credit limit for one or more individual projects.
Each level has an annual budget and an optional monthly budget, and each of those has two thresholds:
  • Warning: The first alert point.
  • Critical: The second alert point, for a higher level of urgency.
A billing notification fires each time consumption crosses one of these thresholds. Maia also sends two system-generated alerts that you don’t configure:
  • Overage alert (account only): Sent when consumption exceeds 100% of your account’s credit allowance. Maia always emails it to all Billing Admins and Super Admins.
  • 100% budget alert (project only): Sent when a project has used 100% of the budget allocated to it. It tells you the project’s allocation is spent—it isn’t an overage alert.

​
View your billing notifications

  1. In the left navigation, click your Profile & Account icon. Then, click Notifications from the menu.
  2. Click the Billing tab.
Each budget you’ve configured appears as a row, showing:
  • Type: Whether the notification is Account or scoped to a Project.
  • Project: The project the notification applies to (blank for account notifications).
  • Annual thresholds: The two threshold levels at which the annual budget’s notification fires, shown as percentages.
  • Monthly thresholds: The two threshold levels at which the monthly budget’s notification fires, shown as percentages (a dash if no monthly budget is configured).
  • Delivery: The channels you’ve added to receive this notification, or a dash if you haven’t added any yet.
You can also reach the Billing tab by clicking Manage notifications on the Budgets and alerts page.

​
Add a billing notification

  1. Click Add notifications at the top of the Billing tab.
  2. On the Add billing notification page, select Account budget thresholds for contract consumption in the Account section to configure a notification for your account budget, and/or select one or more projects from the Project drop-down in the Project section. Only projects that already have a budget configured on the Budgets and alerts page appear in the drop-down.
  3. Under How do you want to receive this notification?, select one or more channels: Email, Slack, or Webhook.
  4. Complete any additional fields required for the channels you selected (see Delivery channels).
  5. Click Save.
If the selected account or project already has a notification configured, it’s replaced with the new settings you define here.

​
Delivery channels

Select a delivery channel to see how it’s set up:
When you select Email, notifications are sent to the email address associated with your Maia account.No additional setup is required. Once you select Email and click Save, notifications are delivered automatically when your thresholds are crossed.

​
Managing billing notifications

After adding a notification, its entry on the Billing tab shows the delivery channels you selected.

​
Edit a billing notification

  1. On the Billing tab, click the … (more options) icon next to the notification you want to update.
  2. Click Edit.
  3. On the Edit billing notification page, review the notification’s project, budget, and thresholds. These are read-only here—to change them, use the Budgets and alerts page instead.
  4. Update your delivery channel selections.
  5. Click Save.

​
Delete a billing notification

  1. On the Billing tab, click the … (more options) icon next to the notification you want to remove.
  2. Click Delete.
  3. Confirm the deletion when prompted.
Deleting a notification removes its delivery channels only—it doesn’t delete the underlying budget or thresholds, which are managed on the Budgets and alerts page.