---
title: "Create an alert channel"
method: POST
path: "/api/v1/alerts/channels"
tags: ["alerts"]
---

# Create an alert channel

`POST /api/v1/alerts/channels`

## Request

- Base URL: `https://monit.rs`
- URL: `https://monit.rs/api/v1/alerts/channels`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `channel_type` 'email' | 'slack' | 'discord' | 'teams' | 'pagerduty' | 'webhook', required
  - `config` object, required
  - `min_severity` 'critical' | 'high' | 'medium' | 'low' | 'info'

## Response `201`

Created.

## Other responses

- `401`: Not authenticated.
- `403`: Missing write:alerts scope.
- `409`: Idempotency-Key reused with different body.
- `422`: Validation error.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/monit/apis/monit-rs-public-api.md) · [All operations](https://skmtc.dev/monit/apis/monit-rs-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/monit/apis/monit-rs-public-api/revisions/7e1923981112?raw)