Overview
Monitoring: Watch an X account for new posts and get them pushed to your own webhook, HMAC-signed, retried for 21 minutes on failure. Polls on a shared interval and never spends your read credits: monitor and webhook management are free account administration, not metered reads.
Watch an X account for new posts and get them pushed to your own webhook, HMAC-signed, retried for 21 minutes on failure. Polls on a shared interval and never spends your read credits: monitor and webhook management are free account administration, not metered reads.
This category has 14 endpoints. Each is a pay-per-call REST endpoint with bearer auth, JSON in and out.
| Method | Path | Cost | Description |
|---|---|---|---|
POST | /monitor | Free | Watch an X account for new posts and push them to your webhook(s). |
GET | /monitor | Free | List every monitor on your account. |
POST | /monitor/{id} | Free | Pause, resume, or change which webhooks a monitor delivers to. |
DELETE | /monitor/{id} | Free | Stop watching an account and remove the monitor. |
GET | /monitor/{id}/health | Free | Check one monitor's poll status and last-seen tweet id. |
GET | /monitor/health | Free | Account-wide monitoring rollup: service status, active/paused counts, 24h delivery outcomes, in one call. |
GET | /monitor/deliveries | Free | Recent delivery events across every monitor, with real detection and delivery latency. |
POST | /oapi/x_user_stream/add_user_to_monitor_tweet | Free | x_user_stream-shaped drop-in for Create Monitor. |
POST | /oapi/x_user_stream/remove_user_to_monitor_tweet | Free | x_user_stream-shaped drop-in for Delete Monitor. |
GET | /oapi/x_user_stream/get_user_to_monitor_tweet | Free | x_user_stream-shaped drop-in for List Monitors. |
POST | /webhook | Free | Register a URL to receive monitor events. |
GET | /webhook | Free | List every webhook on your account. |
POST | /webhook/{id}/test | Free | Fire one real signed test delivery and see the result immediately. |
DELETE | /webhook/{id} | Free | Remove a webhook. |
Create Monitor
Watch an X account for new posts and push them to your webhook(s).
List Monitors
List every monitor on your account.
Update Monitor
Pause, resume, or change which webhooks a monitor delivers to.
Delete Monitor
Stop watching an account and remove the monitor.
Monitor Health
Check one monitor's poll status and last-seen tweet id.
Account Monitor Health
Account-wide monitoring rollup: service status, active/paused counts, 24h delivery outcomes, in one call.
Monitor Deliveries
Recent delivery events across every monitor, with real detection and delivery latency.
Compat: Add User to Tweet Monitoring
x_user_stream-shaped drop-in for Create Monitor.
Compat: Remove User from Tweet Monitoring
x_user_stream-shaped drop-in for Delete Monitor.
Compat: List Tweet-Monitored Users
x_user_stream-shaped drop-in for List Monitors.
Create Webhook
Register a URL to receive monitor events.
List Webhooks
List every webhook on your account.
Test Webhook
Fire one real signed test delivery and see the result immediately.
Delete Webhook
Remove a webhook.
Update Article Cover Image POST
Set the cover image on an article you own, identified by its entity id. This attaches media you have already uploaded; it does not upload anything itself, so call media/upload first and pass the media_id it returns. Requires a registered session. Billed at $0.0016 per call. Cost: $0.0016 per call.
Monitor Health GET
Returns a single monitor's current status, degradation flag, and cursor position, for building your own health dashboard. Cost: Free per call.