Skip to main content
POST
/
monitors
curl -X POST https://api.dataforb2b.ai/monitors \
  -H "api_key: YOUR_api_key" -H "Content-Type: application/json" \
  -d '{
    "signal": "post_engagement",
    "watch": "https://www.linkedin.com/in/jane-doe/",
    "url": "https://your-server.com/webhook"
  }'

curl -X POST https://api.dataforb2b.ai/monitors \
  -H "api_key: YOUR_api_key" -H "Content-Type: application/json" \
  -d '{
    "signal": "post_engagement",
    "watch": [
      "https://www.linkedin.com/in/jane-doe/",
      "https://www.linkedin.com/in/john-roe/"
    ],
    "url": "https://your-server.com/webhook"
  }'

{
  "id": 42,
  "signal": "post_engagement",
  "watch": ["https://www.linkedin.com/in/jane-doe/"],
  "url": "https://your-server.com/webhook",
  "active": true,
  "created_at": "2026-06-12T10:00:00.000000"
}
Create a monitor — a subscription to a signal, delivered to your webhook. An API key can have many monitors. A monitor is just: signal + watch + url.

​
Request Body

​
signal
string
required
The signal to subscribe to — post_engagement. See Signal Catalog.
​
watch
string | array
required
Who to watch — the author’s profile URL. Pass one value or a list (up to 100 per request).
​
url
string
required
HTTPS endpoint where events are delivered.
​
secret
string
Optional. When set, deliveries are signed via X-Webhook-Signature (HMAC-SHA256 of the body).

​
Response

​
id
number
Monitor ID
​
signal
string
The subscribed signal
​
watch
array
What’s being watched (the values you gave)
​
url
string
Delivery URL
​
active
boolean
Whether the monitor is active
​
created_at
string
ISO 8601 timestamp
curl -X POST https://api.dataforb2b.ai/monitors \
  -H "api_key: YOUR_api_key" -H "Content-Type: application/json" \
  -d '{
    "signal": "post_engagement",
    "watch": "https://www.linkedin.com/in/jane-doe/",
    "url": "https://your-server.com/webhook"
  }'

curl -X POST https://api.dataforb2b.ai/monitors \
  -H "api_key: YOUR_api_key" -H "Content-Type: application/json" \
  -d '{
    "signal": "post_engagement",
    "watch": [
      "https://www.linkedin.com/in/jane-doe/",
      "https://www.linkedin.com/in/john-roe/"
    ],
    "url": "https://your-server.com/webhook"
  }'

{
  "id": 42,
  "signal": "post_engagement",
  "watch": ["https://www.linkedin.com/in/jane-doe/"],
  "url": "https://your-server.com/webhook",
  "active": true,
  "created_at": "2026-06-12T10:00:00.000000"
}