---
title: "Create an X (Twitter) monitor that polls a profile, search, list, or replies and fires a webhook on new matches."
method: POST
path: "/v1/x/monitors"
---

# Create an X (Twitter) monitor that polls a profile, search, list, or replies and fires a webhook on new matches.

`POST /v1/x/monitors`

## Request body

- object
  - `kind` 'profile' | 'search' | 'list' | 'replies', required
  - `target` string, required
  - `name` string
  - `interval_minutes` integer
  - `webhook_url` string, uri
  - `include_retweets` boolean
  - `include_replies` boolean
  - `include_quotes` boolean
  - `min_faves` integer
  - `keyword` string
  - `lang` string

## Response `200`

Successful response

- object

## Other responses

- `400` — Invalid request
- `401` — Invalid or missing API key
- `402` — Payment required or insufficient credits
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/webclaw/apis/webclaw-api.md) · [All operations](https://skmtc.dev/webclaw/apis/webclaw-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webclaw/webclaw-api/revisions/bd14a9c72a3b/schema)