> ## 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.

# Create Monitor

> Create a new scheduled enrichment monitor.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Request

<ParamField body="name" type="string" required>
  A display name for the monitor.
</ParamField>

<ParamField body="monitor_type" type="string">
  The type of targets to monitor. Default: `email`.

  Valid values: `email`, `phone`, `domain`, `ip`, `company`, `darkweb`
</ParamField>

<ParamField body="emails" type="string[]">
  List of email addresses to monitor. Required when `monitor_type` is `email`.
</ParamField>

<ParamField body="targets" type="string[]">
  List of targets to monitor (phone numbers, domains, IPs, etc.). Required when `monitor_type` is not `email`.
</ParamField>

<ParamField body="frequency" type="string">
  How often to run enrichment. Default: `monthly`.

  Valid values: `weekly`, `biweekly`, `monthly`, `quarterly`
</ParamField>

<ParamField body="change_detection" type="string">
  Detection mode. Default: `diff_only`.

  Valid values: `diff_only`, `full_refresh`
</ParamField>

<ParamField body="data_source_type" type="string">
  Where targets come from. Default: `csv`.

  Valid values: `csv`, `list`
</ParamField>

<ParamField body="data_source_ref" type="string">
  Reference to a contact list ID when `data_source_type` is `list`.
</ParamField>

### Example: Email monitor

```bash theme={"dark"}
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

```bash theme={"dark"}
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

```bash theme={"dark"}
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.

```json theme={"dark"}
{
  "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"
}
```