---
title: "Create Monitor"
method: POST
path: "/v1/monitor"
tags: ["monitor"]
---

# Create Monitor

`POST /v1/monitor`

## Request

- Base URL: `https://api.snoopscan.com`
- URL: `https://api.snoopscan.com/v1/monitor`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- MonitorRequest
  - `name` string, required: A name for the monitor, up to 120 characters.
  - `url` string, nullable: A page to watch. Give this, `urls`, or both.
  - `urls` string[]: Pages to watch in the one monitor, up to 50.
  - `intervalMinutes` integer: How often to check, in minutes: at least 5, at most a week (10,080).
  - `goal` string, nullable: What you are watching for, in your own words. Stored and returned with the monitor; it does not yet affect which changes are reported.
  - `webhook` string, nullable: A URL to POST to when a check finds a page changed, new or failing.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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