---
title: "POST /CreateAlert"
method: POST
path: "/CreateAlert"
---

# POST /CreateAlert

`POST /CreateAlert`

Creates an alert for an anomaly detector.

## Request body

- object
  - `AlertName` string, required — The name of the alert.
  - `AlertSensitivityThreshold` integer — An integer from 0 to 100 specifying the alert sensitivity threshold.
  - `AlertDescription` string — A description of the alert.
  - `AnomalyDetectorArn` string, required — The ARN of the detector to which the alert is attached.
  - `Action` object, required — A configuration that specifies the action to perform when anomalies are detected.
    - `SNSConfiguration` object — A configuration for an Amazon SNS channel.
      - `RoleArn` string, required — The ARN of the IAM role that has access to the target SNS topic.
      - `SnsTopicArn` string, required — The ARN of the target SNS topic.
      - `SnsFormat` 'LONG_TEXT' | 'SHORT_TEXT' | 'JSON' — <p>The format of the SNS topic.</p> <ul> <li> <p> <code>JSON</code> – Send JSON alerts with an anomaly ID and a link to the anomaly detail page. This is the default.</p> </li> <li> <p> <code>LONG_TEXT</code> – Send human-readable alerts with information about the impacted timeseries and a link to the anomaly detail page. We recommend this for email.</p> </li> <li> <p> <code>SHORT_TEXT</code> – Send human-readable alerts with a link to the anomaly detail page. We recommend this for SMS.</p> </li> </ul>
    - `LambdaConfiguration` object — A configuration for an AWS Lambda channel.
      - `RoleArn` string, required — The ARN of an IAM role that has permission to invoke the Lambda function.
      - `LambdaArn` string, required — The ARN of the Lambda function.
  - `Tags` object — A list of <a href="https://docs.aws.amazon.com/lookoutmetrics/latest/dev/detectors-tags.html">tags</a> to apply to the alert.
  - `AlertFilters` object — The configuration of the alert filters.
    - `MetricList` MetricName[] — The list of measures that you want to get alerts for.
    - `DimensionFilterList` DimensionFilter[] — The list of DimensionFilter objects that are used for dimension-based filtering.
      - `DimensionName` string — The name of the dimension to filter on.
      - `DimensionValueList` DimensionValue[] — The list of values for the dimension specified in DimensionName that you want to filter on.

## Response `200`

Success

- CreateAlertResponse
  - `AlertArn` string — The ARN of the alert.

## Other responses

- `480` — ConflictException
- `481` — ValidationException
- `482` — ServiceQuotaExceededException
- `483` — AccessDeniedException
- `484` — TooManyRequestsException
- `485` — ResourceNotFoundException
- `486` — InternalServerException

---

[API](https://skmtc.net/aws/apis/lookoutmetrics.md) · [All operations](https://skmtc.net/aws/apis/lookoutmetrics/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/lookoutmetrics/versions/aace1e573660/schema)