---
title: "Create an alert"
method: POST
path: "/v1/alerts"
tags: ["Alerts"]
---

# Create an alert

`POST /v1/alerts`

## Request

- Base URL: `https://api.pricetrack.dev`
- URL: `https://api.pricetrack.dev/v1/alerts`
- Auth: HTTP bearer

## Request body

- CreateAlertBody
  - `productSlug` string, required
  - `alertType` 'any_change' | 'increase' | 'decrease' | 'threshold' | 'price_above' | 'price_below', required
  - `thresholdPercentage` integer
  - `targetPrice` number
  - `customLabel` string
  - `deliveryMethod` 'email' | 'webhook' | 'both'
  - `webhookUrl` string, uri

## Response `201`

Alert created

- object
  - `data` object
    - `id` string, uuid

## Other responses

- `400`: Invalid parameters
- `402`: Tier limit reached — upgrade to continue

---

[API](https://skmtc.dev/pricetrack/apis/pricetrack-api.md) · [All operations](https://skmtc.dev/pricetrack/apis/pricetrack-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pricetrack/apis/pricetrack-api/revisions/589cd6882212?raw)