# Receive Alert Notifications via Webhook

> Set up a generic webhook notification channel and receive alert notifications from Last9 at any HTTP endpoint.

Source: https://last9.io/docs/webhook-integration/

## Getting started

The Webhook channel sends alert notifications as JSON to any HTTP endpoint you configure. Use it to forward alerts to custom services, automation, or tools Last9 does not integrate with natively.

For several popular platforms, Last9 auto-detects the webhook URL and formats the payload for that platform instead of sending the generic payload below. See the dedicated guides for [Microsoft Teams](/docs/msteams-integration/), [Flock](/docs/flock-integration/), [Google Chat](/docs/google-chat-integration/), [Telegram](/docs/telegram-integration/), [Jira](/docs/jira-integration/), and [Zenduty](/docs/zenduty-integration/).

## Setting up a notification channel in Last9

1. In [Notification Channels](https://app.last9.io/alerting/notification-channels/), click **Add Channel** and choose **Webhook**.
2. Enter the **webhook URL** of your endpoint.
3. Save the channel. Assign it to an [Alert Group](/docs/alert-rules/#alert-groups-view) to start receiving notifications.

## Notification Payload

The generic webhook payload uses the following fields.

| Field                  | Type             | Description                                                                                                                                            |
| ---------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| routing_key            | string           | The full generic webhook URL generated in Last9. This is used to send alerts to your configured endpoint                                               |
| event_action           | string           | The type of event. Can be `trigger`, `acknowledge` or `resolve`                                                                                        |
| dedup_key              | string           | Deduplication key for correlating triggers and resolves. The maximum permitted length of this property is 255 characters                               |
| payload.summary        | string           | A brief text summary of the event, used to generate the summaries/titles of any associated alerts                                                      |
| payload.source         | string           | The unique location of the affected system, preferably a hostname or FQDN                                                                              |
| payload.severity       | string           | The perceived severity of the status the event is describing with respect to the affected system. This can be `critical`, `error`, `warning` or `info` |
| payload.timestamp      | timestamp        | The time at which the emitting tool detected or generated the event                                                                                    |
| payload.component      | string           | Component of the source machine that is responsible for the event, for example `mysql` or `eth0`                                                       |
| payload.group          | string           | Logical grouping of components of a service, for example `app-stack`                                                                                   |
| payload.class          | string           | The class/type of the event, for example `ping failure` or `cpu load`                                                                                  |
| payload.custom_details | object           | Additional details about the event and affected system                                                                                                 |
| images                 | array of objects | List of images to include                                                                                                                              |
| links                  | array of objects | List of links to include                                                                                                                               |

---

## Troubleshooting

Please get in touch with us on [Discord](https://discord.com/invite/Q3p2EEucx9) or [Email](mailto:support@last9.io) if you have any questions.