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

# Create an alarm

`POST /v2/Alarms`

## Request

- Base URL: `https://monitor.twilio.com`
- URL: `https://monitor.twilio.com/v2/Alarms`
- Auth: HTTP basic

## 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

## Changes

- **2024-12-05** (v2) `7811ecfc26f4`: 29 info
  - added the non-success response with the status `409`
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `429` status
  - …25 more

[Operation history](https://skmtc.dev/twilio/apis/twilio-monitor/changes/v2/Alarms/post.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-monitor.md) - [All operations](https://skmtc.dev/twilio/apis/twilio-monitor/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-monitor/revisions/9c4c6ced36aa?raw)