v11

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0112893437.0 KB

Monitors

Create monitor

Creates an account monitor. Monitors are unlimited. Active monitors check every 1 second and cost 21 credits per hour. Events and webhook deliveries are included. Creation requires available credits for the first hourly charge and username lookup.

post/monitors

Request body

usernamestring required

X username (without @)

eventTypesEventType[] required

Array of event types to subscribe to.

Example request

{
  "username": "elonmusk",
  "eventTypes": [
    "tweet.new",
    "tweet.reply"
  ]
}

Response

Monitor created

idstring required

usernamestring required

xUserIdstring required

eventTypesEventType[] required

Array of event types to subscribe to.

isActiveboolean required

createdAtstring date-time required

nextBillingAtstring date-time required

Next hourly credit charge time. New active monitors are due immediately.

Example response

{
  "id": "42",
  "username": "elonmusk",
  "xUserId": "1234567890",
  "eventTypes": [
    "tweet.new",
    "tweet.reply"
  ],
  "isActive": true,
  "createdAt": "2025-01-15T12:00:00Z",
  "nextBillingAt": "2025-01-15T12:00:00Z"
}