Set up one or more custom webhooks to define notification settings for your [metric alerts](https://coralogix.com/docs/user-guides/alerting/create-an-alert/metrics/threshold-alerts/index.md).

## Set up a custom webhook for your metric alert

### Create a custom webhook

**STEP 1**. Create a [generic outbound webhook](https://coralogix.com/docs/user-guides/alerting/outbound-webhooks/generic-outbound-webhooks-alert-webhooks/index.md) or other custom webhook.

### Define your metric alert notification settings

As you create a [metric alert](https://coralogix.com/docs/user-guides/alerting/create-an-alert/metrics/threshold-alerts/index.md), you must define your alert's **Notifications** settings. You have different options, depending on whether or not you are using the **Group By** condition.

### Using group by

When using **Group By** conditions, you will see the following options:

- **Trigger a single alert when at least one combination of** the group by values meets the condition. A single notification, aggregating all values matching an alert query and conditions, will be sent to your Coralogix Incidents screen.
- **Trigger a separate alert for each combination that meets the condition**. Multiple individual notifications for each Group By field value may be sent to your Coralogix [Incidents Screen](https://coralogix.com/docs/user-guides/alerting/incidents/index.md) when query conditions are met. Select one or more keys – consisting of a subset of the fields selected in the alert conditions – in the drop-down menu. A separate notification will be sent for each key selected.
- When grouping by a given Group By field, you **must** group the metric by this field to allow the data to propagate to the $GROUP_BY_VALUE_1 [parameter](https://coralogix.com/docs/user-guides/alerting/outbound-webhooks/generic-outbound-webhooks-alert-webhooks/#placeholders).
- The number of **Group By** permutations is limited to 1000. If there are more permutations, then only the first 1000 are tracked.

When not using the **Group By** condition, a single alert will be triggered and sent to your [Incidents Screen](https://coralogix.com/docs/user-guides/alerting/incidents/index.md) when the query meets the condition.

### Define notification parameters

- **Notify every**. Sets the alert cadence. After an alert is triggered and a notification is sent, the alert will continue to work, but notifications will be suppressed for the duration of the suppression period.
- **Notify when resolved**. Activate to receive an automatic update once an alert has ceased.
- Define additional alert recipient(s) and notification channels by clicking **+ ADD WEBHOOK**.

## Additional resources

|               |                                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------------ |
| Documentation | [Metric Alerts](https://coralogix.com/docs/user-guides/alerting/create-an-alert/metrics/threshold-alerts/index.md) |

## Next steps

Configure metric threshold-based alerting in [Threshold alerts](https://coralogix.com/docs/user-guides/alerting/create-an-alert/metrics/threshold-alerts/index.md).

## Support

Reach our customer success team 24/7 via the in-app chat or by email at [support@coralogix.com](mailto:support@coralogix.com).