---
title: "Create a change monitor"
method: POST
path: "/v1/monitors"
---

# Create a change monitor

`POST /v1/monitors`

## Request

- Base URL: `https://shotlane.dev`
- URL: `https://shotlane.dev/v1/monitors`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `access_key`

## Request body

- object
  - `url` string, required
  - `kind` 'screenshot' | 'markdown'
  - `interval` 'hourly' | '6h' | 'daily' | 'weekly'
  - `selector` string
  - `threshold` number
  - `full_page` boolean
  - `notify_email` boolean
  - `webhook_url` string

## Response `201`

Monitor

## Other responses

- `400`: Invalid parameters
- `401`: Invalid API key
- `402`: Out of credits
- `422`: Page could not be rendered

---

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