Skip to content

Outbound Webhooks

Outbound webhooks send a notification to a URL of your choice whenever an endpoint finishes executing. Use them to post to Slack, trigger downstream workflows, or log results to external systems.

Add notify_url and optionally notify_on to an endpoint:

endpoints:
- name: deploy
method: POST
command: ./deploy.sh
notify_url: https://hooks.slack.com/services/T.../B.../xxx
notify_on: always

Open Dashboard → Endpoints, click an endpoint, and set the Notify URL and Notify On fields.

ValueFires when
alwaysEvery execution (default)
successCommand exits successfully (exit code 0)
failureCommand fails (non-zero exit code)

The webhook POST includes the endpoint name, exit code, status, duration, and command output. If the endpoint is marked as sensitive, the output is omitted.

Pipelines also support notify_url. The webhook fires once after the entire pipeline run completes — not per step.

  • Slack notifications — post deployment results to a channel
  • Logging — forward execution results to Datadog, Loki, or a custom log sink
  • Chaining — trigger another service after an endpoint completes
  • Alerting — use notify_on: failure to alert only when something breaks