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

# Notifiers

> An introduction to the Qualifire notifiers

Notifiers are a powerful tool for Qualifire. They allow you to receive notifications when a specific event occurs, such as a new Evaluation, a failed Evaluation, or a new Detection. You can configure them to send notifications to various channels, including email, Slack, Custom Webhooks, and more.

To get started, click on the "Notifiers" tab in the settings page. You'll see a list of all the notifiers you have created. Click on the "Add new" button to create a new one.

## Notifier Configuration

<Tabs>
  <Tab title="Webhook">
    To configure a webhook notifier, you'll need to provide the URL for the
    webhook. This can be any URL that accepts a POST request with a JSON body.

    <br />

    Once you have the webhook URL, you can configure the notifier by providing
    the webhook URL.

    <Tip>
      The webhook can have authentication, as a `Authentication` header with the
      provided API key.
    </Tip>

    <Steps>
      <Step number="1">
        Click on the "settings>notifiers" button in the sidebar to access the
        notifiers page. Click on the "Create Notifier" button to create a new
        notifier.
      </Step>

      <Step number="2">
        Select the "Webhook" notifier type and provide the webhook URL. Optionally, you can provide an API key.
      </Step>

      <Step number="3">
        Enter the notifier name and click "Save".
      </Step>
    </Steps>

    <Warning>
      Keep your webhook URLs and API keys secure. Avoid hardcoding them in your application — use environment variables instead. Rotate webhook secrets regularly.
    </Warning>

    **Example webhook payload:**

    <CodeGroup>
      ```json Webhook Payload theme={null}
      {
        "event": "evaluation.failed",
        "timestamp": "2024-01-15T10:30:00Z",
        "evaluation": {
          "id": "eval_abc123",
          "status": "failed",
          "checks": [
            {
              "name": "prompt_injection",
              "result": "INJECTION",
              "score": 15
            }
          ]
        }
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Slack">
    To configure a Slack notifier, you'll need to provide the webhook URL for
    your Slack channel. You can find this URL in the "Incoming Webhooks" section
    of your Slack app settings.

    <br />

    Once you have the webhook URL, you can configure the notifier by providing
    the channel name and the webhook URL.

    <Info>
      For more information on creating an incoming webhook in Slack, see the Slack [documentation](https://api.slack.com/messaging/webhooks).
    </Info>

    <Steps>
      <Step number="1">
        Click on the "settings>notifiers" button in the sidebar to access the
        notifiers page. Click on the "Create Notifier" button to create a new
        notifier.
      </Step>

      <Step number="2">
        Select the "Slack" notifier type and provide the webhook URL.
      </Step>

      <Step number="3">
        Enter the notifier name and click "Save".
      </Step>
    </Steps>
  </Tab>

  <Tab title="Email">
    Configuring an email notifier is straightforward. You can choose the email
    address to send notifications to, as well as the type of email (plain text
    or HTML) and the subject line.
  </Tab>
</Tabs>