---
title: "Create new Alert Notification"
method: POST
path: "/tools/alerts"
tags: ["alerts"]
---

# Create new Alert Notification

`POST /tools/alerts`

Create new Alert Notification

## Request body

- AlertBase
  - `email` string, email, required
  - `percentage` integer — Percentage of usage that will trigger the alert

## Response `201`

Sucess

Alert Notification Created Sucessfully.

- Alert
  - `email` string, email, required
  - `percentage` integer — Percentage of usage that will trigger the alert
  - `id` integer — Alert Id.

## Other responses

- `400` — Bad Request ###### Produces: * missing_required_parameter_email * missing_required_parameter_percentage * percentage_should_be_integer * percentage_should_not_be_less_than_0 * percentage_should_not_be_higher_than_100
- `401` — Unauthorized This API requires a valid API Key to be provided. (Use [/authentication/authorize](#/authentication/AuthenticationLogin) to obtain an API Key) Produces: * missing_authorization_key * invalid_authorization_key * account_is_inactive

---

[API](https://skmtc.net/serversmtp/apis/turbosmtp-public-apis.md) · [All operations](https://skmtc.net/serversmtp/apis/turbosmtp-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serversmtp/turbosmtp-public-apis/versions/8503e099b215/schema)