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

# Create alert channel

`POST /api/v1/alert-channels`

## Request

- Base URL: `https://api-docs.relin.app`
- URL: `https://api-docs.relin.app/api/v1/alert-channels`
- Auth: HTTP bearer

Create a webhook, Slack, or email alert channel.

## Request body

- object
  - `type` 'webhook' | 'slack' | 'email', required
  - `name` string, required
  - `targetUrl` string, uri
  - `targetEmail` string
  - `kinds` string[]

## Response `200`

JSON response

- object
  - `ok` unknown

## Other responses

- `201`: JSON response
- `202`: JSON response
- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response

---

[API](https://skmtc.dev/relin/apis/relin-api.md) · [All operations](https://skmtc.dev/relin/apis/relin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/relin/apis/relin-api/revisions/a845a07c47dd?raw)