> For the complete documentation index, see [llms.txt](/llms.txt).

# Cron jobs

You can schedule actions to run periodically at fixed times or intervals, also known as "cron jobs." For example, you can display a dialog or notification in MetaMask at a specific time each day.

## Steps[​](#steps "Direct link to Steps")

### 1\. Configure a cron job[​](#1-configure-a-cron-job "Direct link to 1. Configure a cron job")

To configure a cron job, request the [endowment:cronjob](/snaps/reference/permissions/#endowmentcronjob)permission, specifying one or more cron jobs in the `jobs` array. Define each job with a [cron expression](https://docs.oracle.com/cd/E12058%5F01/doc/doc.1014/e12030/cron%5Fexpressions.htm)and a request object, which MetaMask sends to the Snap's cron job handler when the job is executed.

For example, to configure a job that executes every minute, add the following to your Snap's manifest file:

snap.manifest.json

```
"initialPermissions": {
  "endowment:cronjob": {
    "jobs": [
      {
        "expression": "* * * * *",
        "request": {
          "method": "execute"
        }
      }
    ]
  }
}

```

### 2\. Implement a cron job handler[​](#2-implement-a-cron-job-handler "Direct link to 2. Implement a cron job handler")

Expose an [onCronjob](/snaps/reference/entry-points/#oncronjob) entry point, which is triggered at the specified schedule with the requests defined in the `endowment:cronjob` permission. The following example handles the `execute` method specified in the previous example:

- JSX
- Functions

index.tsx

```
import type { OnCronjobHandler } from '@metamask/snaps-sdk'
import { Box, Heading, Text } from '@metamask/snaps-sdk/jsx'

export const onCronjob: OnCronjobHandler = async ({ request }) => {
  switch (request.method) {
    case 'execute':
      // Cron jobs can execute any method that is available to the Snap.
      return snap.request({
        method: 'snap_dialog',
        params: {
          type: 'alert',
          content: (
            <Box>
              <Heading>Cron job</Heading>
              <Text>This dialog was triggered by a cron job.</Text>
            </Box>
          ),
        },
      })

    default:
      throw new Error('Method not found.')
  }
}

```

index.ts

```
import type { OnCronjobHandler } from '@metamask/snaps-sdk'
import { panel, heading, text } from '@metamask/snaps-sdk'

export const onCronjob: OnCronjobHandler = async ({ request }) => {
  switch (request.method) {
    case 'execute':
      // Cron jobs can execute any method that is available to the Snap.
      return snap.request({
        method: 'snap_dialog',
        params: {
          type: 'alert',
          content: panel([heading('Cron job'), text('This dialog was triggered by a cron job.')]),
        },
      })

    default:
      throw new Error('Method not found.')
  }
}

```

Access data from cron jobs

When accessing [encrypted data](/snaps/features/data-storage/#use-encrypted-storage) from cron jobs, MetaMask requires the user to enter their password if the wallet is locked. This interaction can be confusing to the user, since the Snap accesses the data in the background without the user being aware.

If the cron job requires access to encrypted data, use [snap_getClientStatus](/snaps/reference/snaps-api/snap%5Fgetclientstatus/) to ensure that MetaMask is unlocked before accessing state. This will prevent an unexpected password request, improving the user's experience.

If the cron job does not require access to sensitive data, store that data in [unencrypted state](/snaps/features/data-storage/#use-unencrypted-storage).

## Example[​](#example "Direct link to Example")

See the [@metamask/cronjob-example-snap](https://github.com/MetaMask/snaps/tree/main/packages/examples/packages/cronjobs)package for a full example of implementing cron jobs.