---
title: "Create an alert"
description: "Creates an alert, which pairs a filter with one or more channels. instant mode sends each matching mention as it arrives. hourly sends a digest of the previous full UTC hour at five past, skips hours with no mention above the rule's minimum, takes no schedule and works with Slack, Telegram and webhook channels only. daily sends one digest at schedule.hour in schedule.timezone. weekly sends one a week on schedule.weekday, from 0 for Sunday to 6 for Saturday. filter.anyOf adds OR logic with groups of mention-list conditions. At least one group must match, as well as the rest of the filter."
canonical: https://docs.rumoro.dev/api/alerts/create-alert
markdown: https://docs.rumoro.dev/api/alerts/create-alert.mdx
---

# Create an alert

`POST /v1/alerts`

Creates an alert, which pairs a filter with one or more channels. instant mode sends each matching mention as it arrives. hourly sends a digest of the previous full UTC hour at five past, skips hours with no mention above the rule's minimum, takes no schedule and works with Slack, Telegram and webhook channels only. daily sends one digest at schedule.hour in schedule.timezone. weekly sends one a week on schedule.weekday, from 0 for Sunday to 6 for Saturday. filter.anyOf adds OR logic with groups of mention-list conditions. At least one group must match, as well as the rest of the filter.

## Body

| Field | Required | Description |
| --- | --- | --- |
| `name` | yes |  |
| `enabled` |  |  |
| `mode` |  |  |
| `filter` |  |  |
| `schedule` |  | Daily and weekly alerts need it, and weekly ones need schedule.weekday too. Hourly alerts send every UTC hour, ignore a time or zone, and reject a weekday. |
| `event` |  | Custom webhook event name. Null keeps the mode's default. |
| `channelIds` |  | Where to send, as ids from GET /v1/channels. |

## Responses

| Status | Meaning |
| --- | --- |
| 201 | The new alert |
| 400 | The schedule doesn't fit the mode, an hourly alert uses email (hourly_email_unsupported), or a channel id is unknown |
| 401 | The API key is missing or not valid |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).