---
title: "Create a monitor watch (5 credits), near-real-time webhooks on change"
method: POST
path: "/api/v1/monitor"
---

# Create a monitor watch (5 credits), near-real-time webhooks on change

`POST /api/v1/monitor`

## Request

- Base URL: `https://www.startuphub.ai`
- URL: `https://www.startuphub.ai/api/v1/monitor`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, required: Company website or domain to watch (e.g. acme.com)
  - `signals` string[]: funding, jobs, tech, headcount, news, status, pricing, domains
  - `frequency` 'weekly' | 'daily' | '12h' | '4h': Poll cadence, clamped to your plan max
  - `webhook_url` string, uri: HTTPS endpoint we POST {event, entity_id, title, body, metadata, delivered_at} to on each change
  - `delivery_channels` string[]

## Response `201`

Watch created

## Other responses

- `402`: Plan watch limit reached
- `409`: Already watching this domain

---

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