# Discord Webhooks

## Discord Setup and Integration

Using the Webhook feature, you can send custom alerts and actions to your Discord server following the steps below. In this example, we are creating a new server, but the webhook can also be set up with an existing Discord server.<br>

**(1)** Click on the **+** symbol in the top left corner of your Discord account to **Add a Server**.

<figure><img src="/files/rHxNWdZQcnNLbvOBj6zA" alt=""><figcaption></figcaption></figure>

**(2)** After clicking on **Create My Own** (or selecting a template), select whether the server is for yourself or for a community.

<figure><img src="/files/UoNWuZOg2uY9voofc1qv" alt=""><figcaption></figcaption></figure>

**(3)** Customize your server with an icon and a name, then click **Create**.

<figure><img src="/files/3BW9FvA1Yc4IpnvLM70P" alt=""><figcaption></figcaption></figure>

**(4)** You have now created your own Discord server! After clicking on the server name, a dropdown menu will open. From there, click on **Server Settings**.

<figure><img src="/files/yKx4lMYcdpxsFZ8YACEi" alt=""><figcaption></figcaption></figure>

**(5)** On the left-side menu, first select **Integrations**, then click on **Create Webhook**.

<figure><img src="/files/gzoTRV45cDAcnouyNcJb" alt=""><figcaption></figcaption></figure>

**(6)** After customizing the webhook to your liking (name and icon), click on **Copy Webhook URL**.

<figure><img src="/files/ZCIHJvhpOrJXVyXmegwy" alt=""><figcaption></figcaption></figure>

**(7)** Next, login to the Keeper Admin Console and visit **Reporting & Alerts.** First click on **Alerts**, then click on an existing alert or create a new one.

<figure><img src="/files/AfpTWVTlzqNjElWKiFWQ" alt=""><figcaption></figcaption></figure>

**(8)** After selecting the desired Event Types and Attributes, click on **Add Recipient**.&#x20;

<figure><img src="/files/z8htzIgRNmBQME69LdYZ" alt=""><figcaption><p>Add Recipient (Teams)</p></figcaption></figure>

**(8)** Type in the Recipient Name and Email Address and click **Add Webhook**.

<figure><img src="/files/2lVUwhbKgI4OvfmSZghu" alt=""><figcaption><p>Add Webhook</p></figcaption></figure>

**(9)** Paste the Webhook URL from **Step 6,** then copy and paste the content for the HTTP body below. Lastly, click **Save**.

<figure><img src="/files/3hYbWIPW7SBr078iLejR" alt=""><figcaption></figcaption></figure>

**(10)** Copy this JSON content and paste it into the **HTTP Body** section in the screenshot above.

```
{
  "content": "Keeper Security Event",
  "embeds": [
    {
      "title": "Alert Name",
      "description": "#alert_name",
      "fields": [
        {
          "name": "Event Details",
          "value": "#description"
        },
        {
          "name": "IP Address",
          "value": "#remote_address"
        },
        {
          "name": "Timestamp",
          "value": "#timestamp"
        }
      ],
      "footer": {
        "text": "Keeper Security Notification"
      }
    }
  ]
}
```

That's it! Below you can find an example of a Discord Webhook alert. Please note that it can take up to 15 minutes for events to start transmitting. You can modify the HTTP Body according to your preferences.

<figure><img src="/files/DBuzdeNKeWnF1JhpUH43" alt=""><figcaption></figcaption></figure>

**References**:

* <https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks>
* <https://support.discord.com/hc/en-us/articles/204849977-How-do-I-create-a-server>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeper.io/en/enterprise-guide/webhooks/discord-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.