---
title: "Create an alarm"
method: POST
path: "/v2/Alarms"
---

# Create an alarm

`POST /v2/Alarms`

## Request body

- MonitorV2AlarmCreateObject — Alarm object
  - `friendlyName` string, required — Friendly name for alarm
  - `queryType` 'ERROR_CODE' | 'LOG_LEVEL' | 'ALL', required — Type of query
  - `query` string — Value to query for
  - `triggerValue` integer, required — Threshold to send customer alarm notification
  - `timeWindow` 'FIVE_MINS' | 'FIFTEEN_MINS' | 'ONE_HOUR' | 'TWELVE_HOURS' | 'ONE_DAY', required — Time window for alarm to trigger
  - `email` string[] — Email notifications to send
  - `webhook` string — Webhook notification to send
  - `consoleIndicator` boolean — Whether to send console notifications
  - `description` string, required — Description for the alarm.
  - `enabled` boolean, required — Is alarm enbled? Default is true.

## Response `201`

Created

- MonitorV2AlarmSidRepsonse — Alarm sid
  - `sid` string

## Other responses

- `400` — BAD REQUEST
- `401` — UNAUTHORIZED
- `409` — CONFLICT
- `429` — TOO MANY REQUEST
- `500` — INTERNAL SERVER ERROR

---

[API](https://skmtc.net/twilio/apis/twilio-monitor.md) · [All operations](https://skmtc.net/twilio/apis/twilio-monitor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-monitor/revisions/9c4c6ced36aa/schema)