- Create a send alert for an account
The metric being monitored.
| Enum Value | Description |
|---|---|
| hard_bounce_rate | Hard bounce rate |
| temporary_fail_rate | Temporary fail rate |
| delivered_rate | Delivery rate |
| complained_rate | Complaint rate |
The comparison operator.
| Enum Value | Description |
|---|---|
| = | Equal |
| != | Not equal |
| < | Less than |
| <= | Less than or equal |
| > | Greater than |
| >= | Greater than or equal |
The dimension to apply to the metric.
| Enum Value | Description |
|---|---|
| domain | Sender domain name, e.g. example.com |
| ip | Sending IP address |
| ip_pool | IP Pool ID |
| recipient_provider | Recipient Provider, e.g. Gmail, Other US, etc. |
| subaccount | Subaccount name |
A list of filters to apply to the alert.
- US Mailgunhttps://api.mailgun.net/v1/thresholds/alerts/send
- EU Mailgunhttps://api.eu.mailgun.net/v1/thresholds/alerts/send
curl -i -X POST \
-u '<username>:<password>' \
https://api.mailgun.net/v1/thresholds/alerts/send \
-H 'Content-Type: application/json' \
-d '{
"name": "hard bounce rate",
"metric": "hard_bounce_rate",
"comparator": "<",
"limit": ".99",
"dimension": "subaccount",
"alert_channels": [
"email",
"webhook",
"slack"
],
"period": "1h"
}'A 200 response
A list of filters to apply to the alert.
The metric being monitored.
| Enum Value | Description |
|---|---|
| hard_bounce_rate | Hard bounce rate |
| temporary_fail_rate | Temporary fail rate |
| delivered_rate | Delivery rate |
| complained_rate | Complaint rate |
The comparison operator.
| Enum Value | Description |
|---|---|
| = | Equal |
| != | Not equal |
| < | Less than |
| <= | Less than or equal |
| > | Greater than |
| >= | Greater than or equal |
The dimension to apply to the metric.
| Enum Value | Description |
|---|---|
| domain | Sender domain name, e.g. example.com |
| ip | Sending IP address |
| ip_pool | IP Pool ID |
| recipient_provider | Recipient Provider, e.g. Gmail, Other US, etc. |
| subaccount | Subaccount name |
{ "id": "915ff385-0a9a-4087-86d5-6727ea7d9b49", "parent_account_id": "12345", "subaccount_id": "67890", "name": "delivery rate", "created_at": "2026-02-01T10:30:00Z", "updated_at": "2026-02-01T10:30:00Z", "last_checked": "2026-02-01T10:30:00Z", "alert_channels": [ "email", "webhook", "slack" ], "metric": "delivered_rate", "comparator": "<", "limit": ".99", "dimension": "subaccount", "period": "1h" }