Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

Skip to main content
POST
/
monitors
Create account monitor
curl --request POST \
  --url https://xquik.com/api/v1/monitors \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "username": "<string>",
  "eventTypes": [
    "<string>"
  ]
}
'
import requests

url = "https://xquik.com/api/v1/monitors"

payload = {
    "username": "<string>",
    "eventTypes": ["<string>"]
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({username: '<string>', eventTypes: ['<string>']})
};

fetch('https://xquik.com/api/v1/monitors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/monitors"

	payload := strings.NewReader("{\n  \"username\": \"<string>\",\n  \"eventTypes\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
Requires 22 available credits - 1 credit for the username lookup plus 21 credits for the first active monitor hour
Monitors are unlimited. Active monitors check every 1 second. Webhook and event deliveries are included in active monitor billing.
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 -c '{
    monitor_id: .id,
    username: .username,
    x_user_id: .xUserId,
    event_types: .eventTypes,
    is_active: .isActive,
    created_at: .createdAt,
    next_billing_at: .nextBillingAt,
    verify_endpoint: "/api/v1/monitors/\(.id)",
    update_endpoint: "/api/v1/monitors/\(.id)",
    delete_endpoint: "/api/v1/monitors/\(.id)",
    events_endpoint: "/api/v1/events?monitorId=\(.id)",
    event_detail_endpoint_pattern: "/api/v1/events/{event_id}",
    webhooks_endpoint: "/api/v1/webhooks",
    deliveries_endpoint_pattern: "/api/v1/webhooks/{webhook_id}/deliveries"
  }'

const response = await fetch("https://xquik.com/api/v1/monitors", {
  method: "POST",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    username: "elonmusk",
    eventTypes: ["tweet.new", "tweet.reply"],
  }),
});
const monitor = await response.json();
const monitorState = {
  monitor_id: monitor.id,
  username: monitor.username,
  x_user_id: monitor.xUserId,
  event_types: monitor.eventTypes,
  is_active: monitor.isActive,
  created_at: monitor.createdAt,
  next_billing_at: monitor.nextBillingAt,
  verify_endpoint: `/api/v1/monitors/${monitor.id}`,
  update_endpoint: `/api/v1/monitors/${monitor.id}`,
  delete_endpoint: `/api/v1/monitors/${monitor.id}`,
  events_endpoint: `/api/v1/events?monitorId=${monitor.id}`,
  event_detail_endpoint_pattern: "/api/v1/events/{event_id}",
  webhooks_endpoint: "/api/v1/webhooks",
  deliveries_endpoint_pattern: "/api/v1/webhooks/{webhook_id}/deliveries",
};
process.stdout.write(`${JSON.stringify(monitorState)}\n`);

import json
import requests

response = requests.post(
    "https://xquik.com/api/v1/monitors",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    json={
        "username": "elonmusk",
        "eventTypes": ["tweet.new", "tweet.reply"],
    },
)
monitor = response.json()
monitor_state = {
    "monitor_id": monitor["id"],
    "username": monitor["username"],
    "x_user_id": monitor["xUserId"],
    "event_types": monitor["eventTypes"],
    "is_active": monitor["isActive"],
    "created_at": monitor["createdAt"],
    "next_billing_at": monitor["nextBillingAt"],
    "verify_endpoint": f"/api/v1/monitors/{monitor['id']}",
    "update_endpoint": f"/api/v1/monitors/{monitor['id']}",
    "delete_endpoint": f"/api/v1/monitors/{monitor['id']}",
    "events_endpoint": f"/api/v1/events?monitorId={monitor['id']}",
    "event_detail_endpoint_pattern": "/api/v1/events/{event_id}",
    "webhooks_endpoint": "/api/v1/webhooks",
    "deliveries_endpoint_pattern": "/api/v1/webhooks/{webhook_id}/deliveries",
}
print(json.dumps(monitor_state))

package main

import (
    "bytes"
    "encoding/json"
    "log"
    "net/http"
    "os"
)

type Monitor struct {
    ID            string   `json:"id"`
    Username      string   `json:"username"`
    XUserID       string   `json:"xUserId"`
    EventTypes    []string `json:"eventTypes"`
    IsActive      bool     `json:"isActive"`
    CreatedAt     string   `json:"createdAt"`
    NextBillingAt string   `json:"nextBillingAt"`
}

type MonitorState struct {
    CreatedAt                  string   `json:"created_at"`
    DeleteEndpoint             string   `json:"delete_endpoint"`
    DeliveriesEndpointPattern  string   `json:"deliveries_endpoint_pattern"`
    EventDetailEndpointPattern string   `json:"event_detail_endpoint_pattern"`
    EventsEndpoint             string   `json:"events_endpoint"`
    EventTypes                 []string `json:"event_types"`
    IsActive                   bool     `json:"is_active"`
    MonitorID                  string   `json:"monitor_id"`
    NextBillingAt              string   `json:"next_billing_at"`
    UpdateEndpoint             string   `json:"update_endpoint"`
    Username                   string   `json:"username"`
    VerifyEndpoint             string   `json:"verify_endpoint"`
    WebhooksEndpoint           string   `json:"webhooks_endpoint"`
    XUserID                    string   `json:"x_user_id"`
}

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "username":   "elonmusk",
        "eventTypes": []string{"tweet.new", "tweet.reply"},
    })

    req, err := http.NewRequest("POST", "https://xquik.com/api/v1/monitors", bytes.NewReader(body))
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()

    var monitor Monitor
    if err := json.NewDecoder(resp.Body).Decode(&monitor); err != nil {
        log.Fatal(err)
    }
    state := MonitorState{
        CreatedAt:                  monitor.CreatedAt,
        DeleteEndpoint:             "/api/v1/monitors/" + monitor.ID,
        DeliveriesEndpointPattern:  "/api/v1/webhooks/{webhook_id}/deliveries",
        EventDetailEndpointPattern: "/api/v1/events/{event_id}",
        EventsEndpoint:             "/api/v1/events?monitorId=" + monitor.ID,
        EventTypes:                 monitor.EventTypes,
        IsActive:                   monitor.IsActive,
        MonitorID:                  monitor.ID,
        NextBillingAt:              monitor.NextBillingAt,
        UpdateEndpoint:             "/api/v1/monitors/" + monitor.ID,
        Username:                   monitor.Username,
        VerifyEndpoint:             "/api/v1/monitors/" + monitor.ID,
        WebhooksEndpoint:           "/api/v1/webhooks",
        XUserID:                    monitor.XUserID,
    }
    if err := json.NewEncoder(os.Stdout).Encode(state); err != nil {
        log.Fatal(err)
    }
}
The cURL, Node.js, Python, and Go examples convert the created or reactivated account monitor into one state row. Store monitor_id, username, x_user_id, event_types, is_active, next_billing_at, verify_endpoint, update_endpoint, delete_endpoint, events_endpoint, event_detail_endpoint_pattern, webhooks_endpoint, and deliveries_endpoint_pattern before routing alerts.

​
Account monitor handoff

Use POST /monitors when a queue, CRM, warehouse, Slack alert, or agent needs 1-second tweet checks for one X account. Create the monitor first. Then create a signed webhook with POST /webhooks. Test it with POST /webhooks/{id}/test.

Monitor ID

Store id as monitor_id. Use Get Monitor to verify state, Update Monitor to pause or resume, and Delete Monitor only when the account should stop permanently.

Stored Account

Store username after trimming the @ prefix and xUserId for identity joins, dedupe, and downstream account mapping.

Event Filter

Store eventTypes; keep List Webhooks subscriptions aligned so expected account activity delivers.

Active State

Read isActive and nextBillingAt before enabling alerts or estimating hourly monitor burn.

Stored Event Join

Use monitorType: "account", monitorId, and username from List Events to join stored events back to the monitored account. Use Get Event for one event’s full payload.

Webhook Delivery Join

Use deliveryId for receiver idempotency and List Deliveries for delivery attempts. Join streamEventId to event IDs; do not use x_event_id as the delivery join key. Store eventType, occurredAt, and data with the downstream job.
Active account monitors check every 1 second and cost 21 credits per active monitor-hour. Creation or reactivation requires 22 available credits: 1 credit for the username lookup plus 21 credits for the first active monitor hour. Pause with Update Monitor (PATCH /monitors/{id}) and { "isActive": false } when the alert should stop.

​
Headers

​
string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.
​
string
required
Must be application/json.

​
Body

​
string
required
X username to monitor. 1-15 characters, alphanumeric and underscores only. The @ prefix is automatically stripped if included.
​
string[]
required
Array of event types to subscribe to. At least 1 required. See Valid Event Types below.

​
Valid event types

Valid account monitor types: tweet.new, tweet.quote, tweet.reply, tweet.retweet, tweet.media, tweet.link, tweet.poll, tweet.mention, tweet.hashtag, tweet.longform, profile.avatar.changed, profile.banner.changed, profile.name.changed, profile.username.changed, profile.bio.changed, profile.location.changed, profile.url.changed, profile.verified.changed, profile.protected.changed, profile.pinned_tweet.changed, profile.unavailable.changed.

tweet.new

Original tweet from the monitored account. Used when no reply, quote, or retweet signal is present.

tweet.quote

Quote tweet from the monitored account. Include this when quote activity should create stored events and webhook deliveries.

tweet.reply

Reply from the monitored account. Include this when support routing, conversation tracking, or alerting needs replies.

tweet.retweet

Retweet from the monitored account. Include this when repost activity should create stored events and webhook deliveries.

​
Response

  • 201 Created
  • 400 Invalid Input
  • 401 Unauthenticated
  • 402 Payment Required
  • 404 User Not Found
  • 409 Duplicate
  • 429 Rate Limited
​
string
Unique monitor ID.
​
string
Stored X username after trimming and removing the @ prefix.
​
string
Resolved X user ID for the account.
​
string[]
Event types this monitor is subscribed to.
​
boolean
Whether the monitor is currently active.
​
string
ISO 8601 timestamp of when the monitor was created.
​
string
Next hourly credit charge time. New active monitors are due immediately.
{
  "id": "7",
  "username": "elonmusk",
  "xUserId": "44196397",
  "eventTypes": ["tweet.new", "tweet.reply"],
  "isActive": true,
  "createdAt": "2026-02-24T10:30:00.000Z",
  "nextBillingAt": "2026-02-24T10:30:00.000Z"
}
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, Update Monitor to pause or resume, Create Webhook to receive events, List Webhooks to check subscriptions, List Events and Get Event to audit stored events, or List Deliveries to inspect webhook attempts.
Last modified on July 22, 2026
Morty Proxy This is a proxified and sanitized view of the page, visit original site.