Notifications

Send a webhook notification after an execution completes. Useful for alerting on failures, posting to Slack, or triggering downstream workflows.

Configuration

[hooks.notification]
url = "https://hooks.slack.com/services/T00/B00/xxx"
on = ["failure", "timeout"]

Outcome filters

Value	Triggers when
`success`	Exit code 0
`failure`	Non-zero exit code
`timeout`	Execution exceeded timeout

Default: ["failure", "timeout"]

Custom headers and body

[hooks.notification]
url = "https://hooks.slack.com/services/..."
method = "POST"
on = ["failure", "timeout"]

[hooks.notification.headers]
Content-Type = "application/json"

[hooks.notification]
body = '{"text": ":warning: {{hook_name}} {{status}} (exit {{exit_code}}, {{duration}})"}'

Available template variables

Variable	Description
`hook_name`	Hook display name
`hook_slug`	Hook URL slug
`status`	Execution outcome
`exit_code`	Process exit code
`execution_id`	Unique execution ID
`duration`	Execution wall time
`trigger_source`	IP address of the caller

Reliability

Notifications are best-effort. A notification failure does not affect the execution record or retry logic.