> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# monitor_create

> Create a scheduled monitor for scrape, crawl, or search targets.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://api.firecrawl.dev/v2/monitor"}</code></div>

```python firecrawl_monitor_create.py theme={null}
from charter.packs import firecrawl

result = await firecrawl.monitor_create.ainvoke({"name": ..., "schedule": ..., "targets": ...})
```

<Warning>
  This tool's JSON schema is 24 KB, because it models the whole resource this endpoint writes.
  That is more context than most tasks. Narrow it at the call site
  with [`Tool.derived`](/charter/charter/reference/tool#tool-derived):

  ```python theme={null}
  narrowed = firecrawl.monitor_create.derived(
      name="monitor_create_narrowed",
      drop={"webhook", "notification.email"},
  )
  ```

  Those are its heaviest branches by schema size, not a recommendation: which ones you can spare is yours to decide. The tool underneath is unchanged.
  See [Projections](/charter/charter/tools/projections).
</Warning>

## Body

<div className="reference-table">
  | Field                                                            | Type                                                                                                                                                                                                                                                               | Description                                                                                                                          |
  | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
  | `name` <span className="required" title="required">\*</span>     | `string`                                                                                                                                                                                                                                                           | Monitor name. <span className="field-constraints">max length 256</span>                                                              |
  | `schedule` <span className="required" title="required">\*</span> | [MonitorSchedule](/charter/charter/packs/firecrawl/monitor/objects#monitorschedule)                                                                                                                                                                                        | Schedule for monitor checks.                                                                                                         |
  | `targets` <span className="required" title="required">\*</span>  | [MonitorScrapeTarget](/charter/charter/packs/firecrawl/monitor/objects#monitorscrapetarget) \| [MonitorCrawlTarget](/charter/charter/packs/firecrawl/monitor/objects#monitorcrawltarget) \| [MonitorSearchTarget](/charter/charter/packs/firecrawl/monitor/objects#monitorsearchtarget)\[] | Targets to run on each check. <span className="field-constraints">min 1 items; max 50 items</span>                                   |
  | `webhook`                                                        | [MonitorWebhook](/charter/charter/packs/firecrawl/monitor/objects#monitorwebhook)                                                                                                                                                                                          | Webhook destination for monitor events.                                                                                              |
  | `notification`                                                   | [MonitorNotification](/charter/charter/packs/firecrawl/monitor/objects#monitornotification)                                                                                                                                                                                | Notification destinations.                                                                                                           |
  | `retentionDays`                                                  | `integer`                                                                                                                                                                                                                                                          | How long to retain monitor history. The server applies 30 when this is absent. <span className="field-constraints">≥ 1; ≤ 365</span> |
  | `goal`                                                           | `string`                                                                                                                                                                                                                                                           | Plain-language goal used to judge whether changed pages are meaningful. <span className="field-constraints">max length 2000</span>   |
  | `judgeEnabled`                                                   | `boolean`                                                                                                                                                                                                                                                          | Whether to judge changed pages against goal.                                                                                         |
</div>