---
title: "Create Price Watch"
method: POST
path: "/v1/price-alerts/watches"
tags: ["price-alerts"]
---

# Create Price Watch

`POST /v1/price-alerts/watches`

## Request

- Base URL: `https://api.trychannel3.com`
- URL: `https://api.trychannel3.com/v1/price-alerts/watches`
- Auth: API key in header `x-api-key`

Create or update a price watch for the user.

## Headers

- `x-user-id` string, nullable

## Request body

- CreatePriceAlertRequest
  - `product_id` string, required
  - `product_title` string, nullable
  - `price_threshold` number, nullable
  - `currency` string
  - `selection` SelectedOption[], nullable
    - `name` string, required: The name of the selected option (e.g. 'Color', 'Size')
    - `label` string, required: The display value of the selected option (e.g. 'Blue', 'XL')

## Response `200`

Successful Response

- UserPriceWatchResponse
  - `product_id` string, required
  - `product_title` string, nullable
  - `price_threshold` number, nullable
  - `currency` string
  - `subscription_id` string, required
  - `selection` object[], nullable
  - `status` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: Unauthorized - Invalid or missing authentication
- `402`: Payment required
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-11-10** `aec5b9e575e8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/changes/v1/price-alerts/watches/post.md)

---

[API](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api.md) - [All operations](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/llms.txt) - [OpenAPI document](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/revisions/aec5b9e575e8?raw)
