# Postman Monitors Integration

Postman is a platform for API development, allowing developers to design, test, document, and monitor APIs. It offers a user-friendly interface and a comprehensive suite of tools to simplify working with APIs, making creating, sharing, and troubleshooting API requests easier. Postman's monitor feature enables developers to schedule and automate API tests. By integrating ilert with Postman, users can automatically send alerts from Postman to their incident management platform, ensuring the prompt delivery of alerts. This guide will walk you through setting up a connection between ilert and Postman.

## In ilert: Create a Postman Monitors 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 **Postman Monitors** in the search field, click the Postman tile, and then **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 **Finish setup** for now.
7. On the final page, an API key and/or webhook URL will be generated. You will need it later.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F4CnhznTeLcACWchOSfTk%2Fil-1.png?alt=media&#x26;token=37cc8789-1028-4d57-90e9-a0f6131b81f8" alt="" width="563"><figcaption></figcaption></figure>

## In Postman: Create a Webhook

1. On the Home page, click **Integrations**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgk1ufvcHwG1ybqot7OlG%2F1.png?alt=media&#x26;token=fd8c6022-1d59-4007-a2f9-08941b8ff4e1" alt="" width="375"><figcaption></figcaption></figure>

2. Now click on **Browse All Integrations**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FPuW81WG4PPlXkjRyXvUb%2F2.png?alt=media&#x26;token=78a54bdd-1fd5-4e57-8db2-a2606483e94f" alt="" width="563"><figcaption></figcaption></figure>

3. In the search field, enter webhooks and click the **Webhooks** tile.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FXObuEo8EGf74S11YQJ0S%2F3.png?alt=media&#x26;token=eea729ed-dc49-4d2b-8850-bdad9f9a0cd2" alt="" width="563"><figcaption></figcaption></figure>

4. Now in the **Post monitoring results** section, click on **Add integration**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FrovC9wmcvCyHeKjouU6m%2F4.png?alt=media&#x26;token=65f5aa57-e9aa-45e8-8d0d-b3e5102ca0b7" alt="" width="563"><figcaption></figcaption></figure>

5. Enter a **Nickname**, choose a desired **workspace** and **Monitor**.
6. Now enter the alert source url created in ilert into the **Webhook URL** field and select **Notify for 3 failures and then first success**.
7. Click on **Add Integration** 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%2FMBo7aelftRGoOf9ckkP3%2F5-2.png?alt=media&#x26;token=0de0e0a7-1999-4c1f-a894-fa0a92cd3022" alt="" width="563"><figcaption></figcaption></figure>

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

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

Yes, as soon as the state of a Monitor in Postman is Healthy again, the alert in ilert will be fixed.
