# Keep Integration

The ilert provider for [Keep](https://docs.keephq.dev/overview/introduction) allows users to create, update, and resolve events or incidents within ilert platform, utilizing its incident management and event notification features to ensure a streamlined and efficient response to incidents.

## In ilert: Create a Keep alert source <a href="#create-alarm-source" id="create-alarm-source"></a>

1. Go to **Alert sources** -> **Alert sources** and click **Create new alert source**.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>
2. Search for **Keep** in the search field, click on the Keep tile, and click **Next**.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>
3. Give your alert source a name, optionally assign teams, and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>
5. Select your [Alert grouping](https://docs.ilert.com/alerting/configure-alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>
6. The next page shows additional settings, such as customer alert templates or notification priority. Click on **Finish setup** for now.
7. An API key and/or webhook URL will be generated on the final page, which you will need later in this guide.
8.

```
<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FxlRBMhxHLZrO9Xa3Zrq1%2F1-il.png?alt=media&#x26;token=aad2b40b-3093-49dd-b87a-e7dfc1dd57d7" alt=""><figcaption></figcaption></figure>
```

## In Keep: Connect a provider

1. On the sidebar, click on **Providers**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F28BGIkzBRwqTMRjtspgr%2F1.png?alt=media&#x26;token=3a9e6510-4fcb-4a99-b8bb-d9aab471ef61" alt="" width="563"><figcaption></figcaption></figure>

2. Now enter 'ilert' into the **Filter providers** search bar and click on the ilert tile.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F88tk7xQ6Nf3ZV5nDEE5T%2F2.png?alt=media&#x26;token=198e69c6-2c48-449c-aa97-49fcf3e84c1b" alt="" width="563"><figcaption></figcaption></figure>

3. Enter a Provider name and the previously created alert source API key into the **ilert API token** field.
4. Click on **Connect** to finish the setup.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F65t3nQxKkYEoCIBYRIZx%2F3.png?alt=media&#x26;token=920304a8-e82f-4d45-b2dc-1667b3de2162" alt="" width="563"><figcaption></figcaption></figure>

## FAQ <a href="#faq" id="faq"></a>

**Will alerts in ilert be resolved automatically?**

Yes, as soon as Keep sends a resolving event, the corresponding alert in ilert will be resolved.

**Will alerts in ilert be accepted automatically?**

Yes, as soon as Keep sends an accept event, the corresponding alert in ilert will be accepted.
