Alert Destinations

Configure webhook and Slack destinations to receive alerts when reputation events or sender pauses occur.

Alert destinations let you route platform alerts to an external endpoint -- a webhook URL or a Slack incoming webhook. When a monitored event occurs (bounce rate spike, sender pause, reputation warning), Molted posts a notification to each active destination.

Create a destination

POST https://api.molted.email/v1/agent/alerts/destinations

curl

curl -X POST https://api.molted.email/v1/agent/alerts/destinations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "webhook",
    "url": "https://hooks.example.com/molted-alerts"
  }'

Response

{
  "id": "dest_abc123",
  "type": "webhook",
  "url": "https://hooks.example.com/molted-alerts",
  "isActive": true,
  "createdAt": "2026-03-31T12:00:00Z"
}

Field	Type	Required	Description
`type`	`string`	Yes	`webhook` or `slack`.
`url`	`string`	Yes	HTTPS URL to post alerts to.

For Slack, use the incoming webhook URL from your Slack app configuration.

List destinations

GET https://api.molted.email/v1/agent/alerts/destinations

curl

curl https://api.molted.email/v1/agent/alerts/destinations \
  -H "Authorization: Bearer YOUR_API_KEY"

Delete a destination

DELETE https://api.molted.email/v1/agent/alerts/destinations/:id

curl

curl -X DELETE https://api.molted.email/v1/agent/alerts/destinations/dest_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Check alert status

Get the current alert status for your tenant -- any active alerts, severity, and the event that triggered them.

GET https://api.molted.email/v1/agent/alerts/status

curl

curl https://api.molted.email/v1/agent/alerts/status \
  -H "Authorization: Bearer YOUR_API_KEY"

Portal management

You can also manage alert destinations from the portal using cookie auth:

Method	Path	Description
`POST`	`/v1/me/alerts/destinations`	Create a destination.
`GET`	`/v1/me/alerts/destinations`	List destinations.
`DELETE`	`/v1/me/alerts/destinations/:id`	Delete a destination.

Domains -- domain setup and verification
Rate Limits -- send quota monitoring

Create a destination

List destinations

Delete a destination

Check alert status

Portal management

Related reading

On this page