MOLTED EMAIL
CLI Reference

molted alerts

Manage alert destinations

CommandDescription
molted alerts destinations listList all alert destinations
molted alerts destinations createCreate an alert destination
molted alerts destinations deleteDelete an alert destination
molted alerts destinations testSend a clearly-labelled test alert to a destination
molted alerts destinations deliveriesList recent delivery attempts for an alert destination

Agent context

Alert destinations define where Molted sends a notification when one of the workspace's alert conditions (the ones molted overrides alerts reports: stale or old review-queue items, send failures, policy blocks, bounce rate, complaints, SLA breaches) reaches warning or critical.

Supported destination types

  • webhook - HTTP endpoint that receives a JSON POST ("event": "alert.fired", with severity and the firing conditions)
  • slack - Slack incoming webhook URL

Create a webhook destination

molted alerts destinations create --type webhook --url https://example.com/hooks/molted
# → every alert notification will POST to this URL

Create a Slack destination

molted alerts destinations create --type slack --url https://hooks.slack.com/services/T.../B.../xxx

List all destinations

molted alerts destinations list

Delete a destination

molted alerts destinations delete <id>

Send a test alert to a destination (bypasses the notification cooldown, clearly labelled as a test so it can't be mistaken for a real alert; at most one test per destination every 30 seconds by default, else 429 "rate_limited"):

molted alerts destinations test <id>
# → { "success": true, "responseCode": 200, "error": null, "deliveryId": "..." }

List recent delivery attempts for a destination (the 50 most recent: success/failure, response code, error, whether it was a test, timestamp):

molted alerts destinations deliveries <id>

Alerts evaluate on a schedule (about every minute, for every workspace with an active destination), not just when something calls "molted overrides alerts". A destination is notified when the set of firing conditions changes, and again every 24 hours while the same conditions keep firing; there is no separate "recovered" notification.

Needs a workspace key (admin, or all mailboxes); creating, deleting and testing need manage scope.

Related: molted domains, molted analytics

Commands

molted alerts destinations list

List all alert destinations

molted alerts destinations list

molted alerts destinations create

Create an alert destination

molted alerts destinations create [options]
OptionDescriptionDefault
--type <type>Destination type (required; one of: webhook, slack)
--url <url>Destination URL (required) (required)

molted alerts destinations delete

Delete an alert destination

molted alerts destinations delete <id>
ArgumentDescriptionRequired
<id>yes

molted alerts destinations test

Send a clearly-labelled test alert to a destination

molted alerts destinations test <id>
ArgumentDescriptionRequired
<id>yes

molted alerts destinations deliveries

List recent delivery attempts for an alert destination

molted alerts destinations deliveries <id>
ArgumentDescriptionRequired
<id>yes

See CLI overview for global options, credentials and output format.