Create monitor

Free — does not consume credits

curl -X POST https://xquik.com/api/v1/monitors \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "elonmusk",
    "eventTypes": ["tweet.new", "tweet.reply"]
  }' | jq

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Content-Type

string

required

Must be application/json.

Body

username

string

required

X username to monitor. 1-15 characters, alphanumeric and underscores only. The @ prefix is automatically stripped if included.

eventTypes

string[]

required

Array of event types to subscribe to. At least 1 required. See Valid Event Types below.

Valid event types

Event Type	Description
`tweet.new`	New original tweet posted
`tweet.quote`	Quote tweet posted
`tweet.reply`	Reply to another tweet
`tweet.retweet`	Retweet of another tweet
`follower.gained`	New follower gained
`follower.lost`	Existing follower lost

Response

string

Unique monitor ID.

username

string

Normalized X username (lowercase, no @ prefix).

xUserId

string

Resolved X user ID for the account.

eventTypes

string[]

Event types this monitor is subscribed to.

createdAt

string

ISO 8601 timestamp of when the monitor was created.

{
  "id": "7",
  "username": "elonmusk",
  "xUserId": "44196397",
  "eventTypes": ["tweet.new", "tweet.reply"],
  "createdAt": "2026-02-24T10:30:00.000Z"
}

{ "error": "invalid_input", "message": "Invalid username format or event types" }

Invalid username format or missing/invalid eventTypes array.

{ "error": "unauthenticated", "message": "Missing or invalid API key" }

Missing or invalid API key.

{ "error": "no_subscription", "message": "No active subscription" }

An active subscription is required to create monitors. Subscribe from the dashboard.

{
  "error": "monitor_limit_reached",
  "message": "Monitor limit reached",
  "limit": 1
}

Your plan allows 1 monitor by default. Add more for $5/month each from the dashboard.

{ "error": "user_not_found", "message": "X user not found" }

The specified X username does not exist or could not be resolved.

{ "error": "monitor_already_exists", "message": "A monitor already exists for this account" }

A monitor already exists for this X account. Use Update Monitor to change event types instead.

{ "error": "shadow_account", "message": "This account appears to be shadow-banned and cannot be monitored" }

The target account appears to be shadow-banned and cannot be monitored.

{ "error": "stream_registration_failed", "message": "Failed to register with streaming service" }

Failed to register the monitor with the streaming service. Try again later.

If a monitor for the same account was previously deleted, it will be silently reactivated with the new event types instead of creating a duplicate.

Next steps: List Monitors to see all your monitors, Get Monitor to fetch details, or Create Webhook to start receiving events at your endpoint.

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Integrations

Draws

Extractions

Compose

Drafts

Styles

Support

Create monitor

Headers

Body

Valid event types

Response

Overview

X API

X Write

Trends

Radar

Account

API Keys

Credits

X Accounts

Monitors

Events

Webhooks

Integrations

Draws

Extractions

Compose

Drafts

Styles

Support

​Headers

​Body

​Valid event types

​Response

Headers

Body

Valid event types

Response