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

# Create new Alert Notification

`POST /tools/alerts`

## Request

- Base URL: `https://pro.api.serversmtp.com/api/v2`
- URL: `https://pro.api.serversmtp.com/api/v2/tools/alerts`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `consumerKey` and API key in header `consumerSecret`

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.dev/serversmtp/apis/turbosmtp-public-apis.md) - [All operations](https://skmtc.dev/serversmtp/apis/turbosmtp-public-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/serversmtp/apis/turbosmtp-public-apis/revisions/8503e099b215?raw)