---
title: "Create a monitor"
method: POST
path: "/v1/monitors"
tags: ["Monitors"]
---

# Create a monitor

`POST /v1/monitors`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/monitors`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Re-runs a list-returning Captapi GET endpoint on your interval and POSTs only new items to your webhook. endpoint must be a Captapi GET path; webhook_url must be an external https URL. interval_minutes is 15-1440 (default 60), at most 20 monitors per account. Each delivery is signed: X-Captapi-Signature is sha256=HMAC-SHA256(secret, "{X-Captapi-Timestamp}.{raw body}"). The secret is generated when omitted and returned here. Managing monitors is free; each scheduled run is billed like calling the endpoint directly.

## Request body

- MonitorCreate
  - `name` string
  - `endpoint` string, required: Captapi GET path, e.g. /v1/reddit/subreddit-posts
  - `params` object
  - `interval_minutes` integer
  - `webhook_url` string, required: HTTPS URL that receives new-item payloads
  - `secret` string, nullable: HMAC secret; generated if omitted

## Response `200`

Success.

- object
  - `success` unknown, required
  - `data` object, required
    - `id` string
    - `name` string
    - `endpoint` string
    - `params` object
      - `url` string
    - `interval_minutes` integer
    - `webhook_url` string
    - `active` boolean
    - `next_run_at` string
    - `created_at` string
    - `secret` string

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.

---

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