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

# Overview

> Send a webhook, Telegram message, or email after each job run, with independent success and failure toggles.

Notifiers send a message after a job runs. They are configured **per job**, in the `notifiers` array of a [job](/configuration/jobs) — there is no global notifiers block. Each entry toggles `onSuccess` and `onFailure` independently, so you can fire on failures only, on every run, or on success.

```yaml snapr.yaml theme={null}
jobs:
  - name: nightly
    schedule: '0 2 * * *'
    # ...
    notifiers:
      - type: telegram
        botToken: env:TG_BOT_TOKEN
        chatId: '-1001234567890'
        onFailure: true
```

## Common fields

Every notifier type accepts these fields:

| Option      | Type   | Required | Default | Description                        |
| ----------- | ------ | -------- | ------- | ---------------------------------- |
| `type`      | enum   | Yes      | —       | `webhook`, `telegram`, or `email`. |
| `name`      | string | No       | —       | Label shown in the UI and logs.    |
| `onSuccess` | bool   | No       | `false` | Fire on successful runs.           |
| `onFailure` | bool   | No       | `false` | Fire on failed runs.               |

<Note>If both `onSuccess` and `onFailure` are `false`, the notifier never fires — it is effectively disabled.</Note>

## Types

<Columns cols={2}>
  <Card title="Webhook" icon="globe" href="/configuration/notifiers/webhook">
    HTTP request with a JSON run summary to any URL.
  </Card>

  <Card title="Telegram" icon="paper-plane" href="/configuration/notifiers/telegram">
    Message from your bot to a chat, group, or channel.
  </Card>

  <Card title="Email" icon="envelope" href="/configuration/notifiers/email">
    SMTP email to one or more recipients.
  </Card>
</Columns>