Skip to main content
POST
/
api
/
agent
/
monitors
Create Monitor
curl --request POST \
  --url https://encrata.com/api/agent/monitors \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "monitor_type": "<string>",
  "emails": [
    "<string>"
  ],
  "targets": [
    "<string>"
  ],
  "frequency": "<string>",
  "change_detection": "<string>",
  "data_source_type": "<string>",
  "data_source_ref": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.encrata.com/llms.txt

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

​
Authentication

Requires an API key in the Authorization header. 
Authorization: Bearer YOUR_API_KEY

​
Request

​
name
string
required
A display name for the monitor.
​
monitor_type
string
The type of targets to monitor. Default: email.Valid values: email, phone, domain, ip, company, darkweb
​
emails
string[]
List of email addresses to monitor. Required when monitor_type is email.
​
targets
string[]
List of targets to monitor (phone numbers, domains, IPs, etc.). Required when monitor_type is not email.
​
frequency
string
How often to run enrichment. Default: monthly.Valid values: weekly, biweekly, monthly, quarterly
​
change_detection
string
Detection mode. Default: diff_only.Valid values: diff_only, full_refresh
​
data_source_type
string
Where targets come from. Default: csv.Valid values: csv, list
​
data_source_ref
string
Reference to a contact list ID when data_source_type is list.

​
Example: Email monitor

curl -X POST https://encrata.com/api/monitors \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "name": "Engineering team",
    "monitor_type": "email",
    "emails": ["satya@microsoft.com", "sundar@google.com"],
    "frequency": "monthly",
    "change_detection": "diff_only"
  }'

​
Example: Domain monitor

curl -X POST https://encrata.com/api/monitors \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "name": "Domain Portfolio",
    "monitor_type": "domain",
    "targets": ["example.com", "mysite.io"],
    "frequency": "weekly",
    "change_detection": "diff_only"
  }'

​
Example: Dark web monitor

curl -X POST https://encrata.com/api/monitors \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "name": "Brand Leak Watch",
    "monitor_type": "darkweb",
    "targets": ["acme corp", "acme.com credentials"],
    "frequency": "monthly",
    "change_detection": "diff_only"
  }'

​
Response

Returns the created monitor object. 
{
  "id": "a1b2c3d4-...",
  "name": "Domain Portfolio",
  "monitor_type": "domain",
  "frequency": "weekly",
  "change_detection": "diff_only",
  "status": "active",
  "tracked_fields": [],
  "target_count": 2,
  "next_run_at": "2026-05-22T12:00:00Z",
  "created_at": "2026-05-15T12:00:00Z"
}