Notifications

Get alerted when scripts fail or succeed.

Overview

Humrun can notify you when your scripts fail or succeed. Stay informed without constantly checking the dashboard.

Notification modes

Configure notifications for each script:

  • Alert - Get notified when a run fails or times out
  • Report - Get notified when a run succeeds (useful for daily digests)

Most users use "alert" mode to know when things break.

Notification channels

Email

Send notifications to any email address.

Email notifications include:

  • Script name
  • Run status
  • Output (for reports) or error message (for alerts)

Webhooks

Send notifications to any URL. Useful for integrating with Slack, Discord, or your own systems.

Webhook payloads are JSON:

{
  "job_id": "uuid",
  "job_name": "Check API status",
  "run_id": "uuid",
  "status": "failed",
  "exit_code": 1,
  "trigger": "scheduled",
  "started_at": "2024-01-15T10:30:00Z",
  "finished_at": "2024-01-15T10:30:05Z",
  "stdout": "",
  "stderr": "Connection timeout"
}

Status values:

  • success
  • failed
  • timeout

Sending custom emails

Humrun scripts run in a standard Python environment. You can use Python's built-in smtplib to send emails via your own SMTP server.

We recommend this only for advanced use cases. For most notifications, use Humrun's built-in email or webhook notifications.