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

# Extraction schedulers

> Configure first-time and recurring extractions for the entities your organization monitors.

Extraction schedulers automate [extraction](/using-syntage/extractions) creation. Use them to decide which information Syntage should retrieve when an entity is onboarded and which information should be refreshed on a recurring schedule.

## Scheduler types

| Scheduler  | Purpose                                                        |
| ---------- | -------------------------------------------------------------- |
| First time | Runs when an entity is created or onboarded for the first time |
| Recurring  | Runs periodically for entities that match the scheduler's tags |

First-time schedulers help your organization start with the data it needs immediately after onboarding. Recurring schedulers keep selected entities current over time.

## Review first-time extraction rules

1. Open [Extraction Schedulers](https://app.syntage.com/settings/extraction-schedulers).
2. Edit the scheduler named **First time**.
3. Review the configured rules.

Each rule defines the extractor and any required parameters, such as period, invoice type, or document type.

## Change first-time extraction rules

1. Open [Extraction Schedulers](https://app.syntage.com/settings/extraction-schedulers).
2. Edit **First time**.
3. Add, edit, or delete rules.
4. Click **Update** to save the scheduler.

To disable automatic first-time extractions, turn off **Enable** and save the scheduler.

<Warning>
  If you disable the first-time scheduler, new entities will not automatically have data available after onboarding. Your team will need to create extractions manually.
</Warning>

## Create a recurring scheduler

1. Open [Extraction Schedulers](https://app.syntage.com/settings/extraction-schedulers).
2. Click **Add new**.
3. Name the scheduler.
4. Select the tags that identify the entities this scheduler should target.
5. Save the scheduler.
6. Add rules with the extractor, frequency, period, and extractor-specific options.
7. Enable the scheduler.
8. Click **Update**.

Use tags carefully. A broad tag can cause the scheduler to run for more entities than intended.

## Cron expressions for scheduler rules

Each scheduler rule uses a `cronExpression` field to control when it runs. The field accepts any valid cron string, and named aliases such as `@daily`, `@weekly`, and `@monthly` are also supported.

Common examples:

| Expression    | Runs                                     |
| ------------- | ---------------------------------------- |
| `@hourly`     | Every hour, at minute `0`                |
| `@daily`      | Every day at midnight                    |
| `@weekly`     | Every Sunday at midnight                 |
| `@monthly`    | The first day of every month at midnight |
| `0 9 * * *`   | Every day at 09:00                       |
| `0 9 * * 1`   | Every Monday at 09:00                    |
| `0 6 1 * *`   | The first day of every month at 06:00    |
| `0 */6 * * *` | Every 6 hours                            |

Schedules are evaluated in UTC. Convert from local time before saving the rule.

## Disable a recurring scheduler

1. Open [Extraction Schedulers](https://app.syntage.com/settings/extraction-schedulers).
2. Edit the recurring scheduler.
3. Turn off **Enable**.
4. Click **Update**.

Return to the scheduler list and confirm the status changed to disabled.

## Estimate monthly usage

Recurring extraction usage depends on how many entities match the scheduler, how many rules it has, and how often the rules run.

Use this estimate before enabling a scheduler:

```text theme={null}
matching entities x total monthly runs
```

For example, if 55 entities match a scheduler and it runs 37 times in a month, the scheduler may create about 2,035 extraction requests for that month.

Actual usage depends on the configured rules, datasource availability, plan limits, and whether extractions complete successfully.