---
title: How to use billing alerts
description: Set up billing alerts to monitor your Scaleway spending.
tags: billing-alert alerts billing budget
dates:
  validation: 2025-09-03
  posted: 2024-02-14
---
import Requirements from '@macros/iam/requirements.mdx'


Billing alerts allow you to oversee your expenses efficiently. This feature allows you to create alerts that notify you when predefined budget thresholds are met. Your alerts can be seamlessly delivered through SMS, email, or API webhooks.

Your budget, denominated in euros, represents the limit for your expenses. Simultaneously, the threshold corresponds to a predetermined percentage of this budget. You have the autonomy to define both the budget and the threshold within the Scaleway console.

**For example:**

  - If you have defined a budget of €1,000, you may configure an email notification to be sent once you have consumed 50% of this limit. In this case, once your consumption reaches €500, you will receive an email informing you that the limit threshold has been reached.

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization

## How to create a billing alert

1. Click **Billing** in the top-right drop-down menu to go to the **Billing Overview** page.
    <Message type="tip">
      Alternatively, you can reach the [billing page](https://console.scaleway.com/billing/overview) from your [Organization Dashboard](https://console.scaleway.com/organization) by clicking **Go to Billing** above the **Current consumption** area.
    </Message>
2. Click the **Consumption** tab.
3. Scroll down to **Billing alerts**.
4. Click **+ Create a billing alert** to configure your first alert. If you already have an alert, click **+ Add alert** A pop-up displays.
5. Enter your monthly budget.
    <Message type="note">
      If your budget was already set previously, the first budget is the one that applies to all active alerts. You can click <Icon name="edit" /> next to your budget to change it anytime. This automatically changes the budget for all recurring alerts.
    </Message>
6. Enter the threshold that triggers the alert in percentage.
7. Select how you want to receive your alerts. You can choose one or more of the following:
    - SMS notifications - indicate the phone number
    - E-mail notifications - indicate the email address
    - Webhook triggers - indicate the webhook URL
6. Click **Create billing alert** to enable the alert.

    You may configure up to 10 billing alerts based on your monthly budget. To create a new billing alert, click **+ Add alert**, and repeat the steps above.

  <Message type="important">
    - Billing alerts only provide a rough estimate of what may be charged to your monthly invoice. Additional costs related to your usage before the alert is triggered may still appear on your invoice after the alert is generated. Only your monthly invoice is considered legally valid.
    - The consumption monitor displays usage excluding taxes, while billing alerts are triggered based on the total amount including taxes. This discrepancy means the monitor may not fully reflect the actual billed amount.
    - Alerts are **based on the amount that will be charged to your account** after any discounts and taxes are applied. This means the alert reflects your **actual spending**, not your total usage.
      **Example:**
      - **You have a €100 discount** on your account.
      - You set an alert for **100% of a €150 budget**.
      - The alert will trigger when **€150 has been charged to your account**, not when you have consumed €150 in total usage.
      - In this case, you may have consumed **€250 in total usage**, but because of your €100 discount, only **€150 is billed**, and that is when the alert is sent.
  </Message>

### Webhook API Call

When you configure a Webhook, an `HTTP` request is made to the configured URL. It transmits the following information as an `HTTP POST` request to the specified URL:

```
Header: "Content-Type": "application/json"
POST /my/configured/webhook
{
    "invoice_start_date": <INVOICE_START_DATE>,
    "threshold": <THRESHOLD_VALUE_IN_PERCENT>
}
```
## How to delete a billing alert

1. Click **Billing** in the top-right drop-down menu to go to the **Billing Overview** page.
2. Click the **Consumption** tab.
3. Scroll down to **Billing alerts**.
4. Click <Icon name="more" /> > **Delete alert** next to the alert. A pop-up appears.
5. Click **Delete alert** to confirm.

## How to delete the alert budget

1. Click **Billing** in the top-right drop-down menu to go to the **Billing Overview** page.
2. Click the **Consumption** tab.
3. Scroll down to **Billing alerts**.
4. Click <Icon name="delete" /> next to the alert budget. A pop-up appears.
5. Type **DELETE**, then click **Confirm**.
    <Message type="important">
      When you delete a budget, all your alerts are deleted as well.
    </Message>