HomeConsoleAccountHow to
Use billing alerts
Jump toUpdate content

How to use Billing Alerts

Reviewed on 28 June 2023Published on 11 June 2021

The Scaleway console Billing Alerts feature allows you to manage and keep track of your expenses by setting up alerts to trigger when a budget threshold is reached. An alert can be sent to you by SMS, email or API webhook.

The budget is the limit of your expenses, in euros. The threshold is a percentage of this limit. Both are previously defined by you in the console.

For example:

  • If you have defined a budget of €1000, you may configure an email notification to be sent once you have consumed 50% of this limit. In this case, once your consumption gets to €500 you will receive an email informing you the limit threshold has been reached.
Security & Identity (IAM):

You may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets
Requirements:
  1. Go to the Billing overview page by clicking on Billing in the Organization drop-down menu of the Scaleway console.
  2. Click «Toogle Icon» under Enable billing alerts to enable billing alerts. Enter the trigger monthly maximum invoice amount in the box.
    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.

  3. Click Create a billing alert to configure an alert action. A pop-up displays.
  4. Enter the percentage threshold that triggers the alert and configure the warning that will be sent. Avialable warning types are:
    • SMS notifications
    • E-mail notifications
    • Webhook triggers
  5. Click Create billing alert to enable the alert. You may set up to 10 billing alerts. If you wish to add more, click Add billing alert and repeat the steps above.

Webhook API Call

When you configure a Webhook, an HTTP request is made to the configured URL. It will transmit the following information as an HTTP POST request to the given URL:

Header: "Content-Type": "application/json"
POST /my/configured/webhook
{
"invoice_start_date": <INVOICE_START_DATE>,
"threshold": <THRESHOLD_VALUE_IN_PERCENT>
}
See Also