---
title: "Create a delivery channel"
method: POST
path: "/api/v1/channels"
---

# Create a delivery channel

`POST /api/v1/channels`

## Request

- Base URL: `https://app.pingvera.com`
- URL: `https://app.pingvera.com/api/v1/channels`
- Auth: HTTP bearer

Scope write:channels. Organization — from the token. type: email|telegram|max|webhook|slack|discord|vk. The response for a webhook channel CONTAINS the secret field ONCE (HMAC signature, docs/webhooks.md) — save it right away, it is not returned again.

## Request body

- object
  - `type` string, required
  - `name` string, required
  - `config` object: per-type: {url} for webhook/slack/discord, {address} for email

## Response `201`

Created — {channel: {...}, secret?: "whsec_..."}

## Other responses

- `400`: invalid config
- `401`: missing/invalid token
- `402`: plan's channel quota exceeded
- `403`: missing write:channels scope

---

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