---
search:
  tags:
    - alerts
    - POST
seo:
  description: >-
    A global destination receives every alert of the… Reference for the POST
    /api/v1/alert-delivery/destinations endpoint in the TimescaleDB Enterprise
    API.
sidebar:
  label: Add an alert destination
  badge: POST
title: Add an alert destination
type: openapi-operation
---
A global destination receives every alert of the services that inherit the global routing, and every alert that has no service. The heartbeat goes to none. Stored encrypted.

`POST /api/v1/alert-delivery/destinations`

**Request body** (`application/json`, required)

- `global` (boolean) — Omit for true
- `kind` (string, required)
- `minSeverity` (string) — Omit for warning: every alert
- `name` (string, required) — 1 to 64 characters after trimming
- `url` (string, required) — Absolute http/https URL; https for slack and msteams. For email: one recipient address or a comma-separated list

Request body example:

```json
{
  "global": true,
  "kind": "webhook",
  "minSeverity": "warning",
  "name": "string",
  "url": "string"
}
```

**Responses**

- `201` — Created
- `default` — Error

Response example, 201:

```json
{
  "display": "string",
  "global": true,
  "id": 0,
  "kind": "webhook",
  "minSeverity": "warning",
  "name": "string",
  "usedBy": [
    {
      "serviceId": "string",
      "serviceName": "string"
    }
  ]
}
```
