> ## 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](https://docs.syntage.com/using-syntage/extractions.md) 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.

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

When you enable a recurring scheduler, Syntage sends an activation email that summarizes the configured rules and the extractions the scheduler is likely to generate.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.