---
title: "api/alerts/{id} POST Create the specified user alert."
method: POST
path: "/api/alerts"
tags: ["Api\\AlertController"]
---

# api/alerts/{id} POST Create the specified user alert.

`POST /api/alerts`

## Headers

- `Authorization` string
- `Content-Type` string
- `Accept` string
- `Accept-language` string

## Request body

- object
  - `alert_rule_id` integer, required — The alert rule that has been alerted for.
  - `measurement_id` integer, required — The physical quantity / unit to alert for.
  - `alert_value` string, required — The alert value.
  - `show` boolean — Set to false (0) if the alert should NOT be shown anymore.

## Changes

- **2022-06-20** `a87569f002e1` — 1 info
  - added the new optional `header` request parameter `Accept-language`
- **2022-06-10** `568ca15f3476` — 1 warning
  - deleted the `header` request parameter `Accept-language`

[Change history](https://skmtc.dev/beepnl/apis/beep/changes/api/alerts/post.md)

---

[API](https://skmtc.dev/beepnl/apis/beep.md) · [All operations](https://skmtc.dev/beepnl/apis/beep/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beepnl/beep/revisions/a87569f002e1/schema)