---
title: "Occasion alert signup (WS7) — venue/category/keyword watch rule"
method: POST
path: "/api/v1/watch"
tags: ["subscribe"]
---

# Occasion alert signup (WS7) — venue/category/keyword watch rule

`POST /api/v1/watch`

## Request

- Base URL: `https://api.vikenda.com`
- URL: `https://api.vikenda.com/api/v1/watch`
- Auth: none declared

## Request body

- WatchRuleBody: Occasion alert signup, e.g. 'tell me when Icewine Festival dates drop'. Requires an already-confirmed (or pending) subscriber address.
  - `email` string, email, required
  - `rule_type` 'venue' | 'category' | 'keyword', required
  - `match_value` string, required
  - `trigger_type` 'new_event' | 'date_announced' | 'cancelled', required
  - `area` string

## Response `201`

Alert active or pending confirmation.

- SubscribeResult
  - `status` 'pending' | 'already_subscribed', required
  - `message` string, required

## Other responses

- `400`: Invalid input.

---

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