# Webhooks page

The **Webhooks** page is an overview of all the webhooks you have configured on your Flagship account. This page enables you to trigger alerts depending on the type of actions performed on your account.

## 📖 Definition

A **Webhook** is a way for applications/software to send alerts to third-party applications in real time when an event happens. It is configured to send push notifications to a URL (Hook URL) designated by the tier interested in the event.\
Each event triggering the Webhook URL will have specific parameters (such as the name of the event) and common ones (such as the date and time).\
For more information on webhooks, refer to the [developer portal](https://developers.flagship.io/docs/third-party/webhooks).

## ⚙️ Configuration

To access the **Webhooks** page, go to *Settings* > *Platform Integration* > *Webhooks* tab.

![Webhooks\_page.png](https://195542843-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPLcJUpntQruhbI1jQ2kr%2Fuploads%2Fgit-blob-58b296d10f80ed77f2c9157f2c7cb0c5cdbe774a%2Fc113d73ac334071e75d794469996f8e8.png?alt=media)To create a webhook, apply the following steps:

1. Click *Create*.
2. Choose the event you want to be alerted on.
3. Insert the webhook URL which should receive the alerts.
4. Insert a short description to remember what this webhook is for.
5. Click *Create*:\
   The created webhook appears in a new line.

![Hook\_URL.png](https://195542843-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPLcJUpntQruhbI1jQ2kr%2Fuploads%2Fgit-blob-09e8cf90e43553df423a4e7b0fdbce1ea05e0ca2%2F129c2eb409dc9981748a299be1161c0e.png?alt=media)

Here is the list of event types you can receive an alert on:

| **Event type**          | **Gives an alert when...**                                                       |
| ----------------------- | -------------------------------------------------------------------------------- |
| Feature.status          | The feature status has changed (ON and OFF)                                      |
| Feature.active          | The feature has been turned ON                                                   |
| Feature.paused          | The feature has been turned OFF                                                  |
| Flag.new                | A new flag has been created in your codebase.                                    |
| Flag.deleted            | A flag has been deleted from your codebase.                                      |
| Environment.synchronize | A modification has been made on the platform and has an impact on your campaigns |

## 💡 Use case

Let’s say you and your team are planning to launch several features during the next quarter. Five people are managing your Flagship account and working on the features (activation/deactivation, etc.). To be notified when a feature is pushed ON or OFF by any member of your team, you can configure a webhook.\
To do so, you must create the webhook in your codebase beforehand and thus generate your own hook URL to reach it. Then, you can create a webhook via the **Webhooks tabs** of your Flagship account:

1. From the drop-down list, select the *feature.status* event style.
2. Fill in the corresponding Hook URL that you generated.
3. Add a description.
4. Click *Create*.

Now you can manage your Flagship features more easily.

| <p>⭐ Good to know</p><p>To automate these alerts, you may consider using our <a href="https://flagship.zendesk.com/hc/en-us/articles/360021125079">Zapier integration</a>.</p> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

**Need additional information?**

Submit your request at [product.feedback@abtasty.com](mailto:product.feedback@abtasty.commailto:product.feedback@abtasty.com?subject=Flagship%20Custom%20Integration%20Feedback)

Always happy to help!