---
title: "Create Alert"
method: POST
path: "/api/v1/alerts"
tags: ["alerts"]
---

# Create Alert

`POST /api/v1/alerts`

## Request

- Base URL: `https://geo.sig.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://geo.sig.ai/api/v1/alerts`
- Auth: HTTP bearer

Create a new alert rule.

## Cookies

- `access_token` string, nullable

## Request body

- AlertCreate: Schema for creating an alert.
  - `name` string, required: Alert name
  - `alert_type` string, required: Alert type
  - `brand_id` string, uuid, nullable: Brand ID (null = all brands)
  - `is_enabled` boolean: Whether alert is enabled
  - `conditions` object, required: Alert condition configuration
  - `channels` object[], required: Notification channels
  - `cooldown_minutes` integer: Cooldown between triggers
  - `max_triggers_per_day` integer: Max triggers per day

## Response `201`

Successful Response

- AlertResponse: Schema for alert response.
  - `name` string, required: Alert name
  - `alert_type` string, required: Alert type
  - `brand_id` string, uuid, nullable: Brand ID (null = all brands)
  - `is_enabled` boolean: Whether alert is enabled
  - `conditions` object, required: Alert condition configuration
  - `channels` object[], required: Notification channels
  - `cooldown_minutes` integer: Cooldown between triggers
  - `max_triggers_per_day` integer: Max triggers per day
  - `id` string, uuid, required
  - `account_id` string, uuid, required
  - `created_by` string, uuid, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `last_triggered_at` string, date-time, nullable, required
  - `trigger_count_today` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api.md) · [All operations](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/revisions/3ec39f9be9e0?raw)