---
title: fastly service alert create
summary: Create Alert
url: https://www.fastly.com/documentation/reference/cli/service/alert/create
---

Create Alert

## Flags

| Flag | Description | Required | Default |
|------|-------------|----------|----------|
| `--description` | Additional text that is included in the alert notification. | Yes | - |
| `--metric` | Metric name to alert on for a specific source. | Yes | - |
| `--name` | Name of the alert definition. | Yes | - |
| `--period` | Period of time to evaluate whether the conditions have been met. The data is polled every minute. | Yes | - |
| `--source` | Source where the metric comes from. | Yes | - |
| `--threshold` | Threshold used to alert. | Yes | - |
| `--type` | Type of strategy to use to evaluate. | Yes | - |
| `--dimensions` | Dimensions filters depending on the source type. | No | - |
| `--ignoreBelow` | IgnoreBelow is the threshold for the denominator value used in evaluations that calculate a rate or ratio. Usually used to filter out noise. | No | - |
| `--integrations` | Integrations are a list of integrations used to notify when alert fires. | No | - |
| `--json` | Render output as JSON | No | - |
| `--service-id` | ServiceID of the definition | No | - |

## Global options

| Flag | Description | Required | Default |
|------|-------------|----------|----------|
| `--help` | Show context-sensitive help. | No | - |
| `--accept-defaults` | Accept default options for all interactive prompts apart from Yes/No confirmations | No | - |
| `--auto-yes` | Answer yes automatically to all Yes/No confirmations. This may suppress security warnings | No | - |
| `--debug-mode` | Print API request and response details (NOTE: can disrupt the normal CLI flow output formatting) | No | - |
| `--non-interactive` | Do not prompt for user input - suitable for CI processes. Equivalent to --accept-defaults and --auto-yes | No | - |
| `--quiet` | Silence all output except direct command output. This won't prevent interactive prompts (see: --accept-defaults, --auto-yes, --non-interactive) | No | - |
| `--token` | Fastly API token, or name of a stored auth token (use 'default' for the default token). Falls back to FASTLY_API_TOKEN env var | No | - |
| `--verbose` | Verbose logging | No | - |