---
title: "Create Monitor"
method: POST
path: "/monitors"
---

# Create Monitor

`POST /monitors`

## Request

- Base URL: `https://seoscoreapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://seoscoreapi.com/monitors`
- Auth: none declared. Required headers: `X-API-Key`

Set up SEO score monitoring for a URL. Paid plans only.

Send JSON:
  {
    "url": "https://example.com",
    "frequency": "daily" | "weekly",
    "webhook_url": "https://hooks.slack.com/services/..." (optional),
    "alert_threshold": 5  (optional, points; default 5)
  }

If webhook_url is a Slack incoming-webhook URL it is auto-formatted
as a Slack Block Kit message; otherwise the raw event JSON is POSTed.

## Headers

- `X-API-Key` string, required

## Request body

- object
  - `url` string, uri, required
  - `frequency` 'daily' | 'weekly'
  - `webhook_url` string, uri: Optional. A Slack incoming-webhook URL gets a formatted message.
  - `alert_threshold` number: Points.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/seoscoreapi/apis/seo-score-api.md) · [All operations](https://skmtc.dev/seoscoreapi/apis/seo-score-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seoscoreapi/apis/seo-score-api/revisions/877a3044b5be?raw)