Notifications
Configuring Slack, Discord, webhook, and email notifications for execution events.
Overview
SculptOps can notify your team when executions succeed or fail. Notifications are configured at the organization level and delivered through one or more channels: Slack, Discord, a generic HTTP webhook, and email (SMTP). Each channel has its own on-success / on-failure conditions.
Notification channels
| Channel | How it delivers |
|---|---|
| Slack | Incoming webhook URL |
| Discord | Incoming webhook URL |
| Generic webhook | Any HTTP endpoint, JSON payload |
| Email (SMTP) | One or more recipient addresses via your SMTP server |
Configure channels under Settings → Notifications. For each channel you enable, choose whether it fires on failed runs, successful runs, or both.
SMTP setup
Go to Settings → Notifications → SMTP and fill in your mail server details.
| Field | Description |
|---|---|
| Host | SMTP server hostname |
| Port | Usually 587 (STARTTLS) or 465 (TLS) |
| Secure (TLS) | Enable for port 465 |
| Username | SMTP auth username |
| Password | SMTP auth password (stored encrypted) |
| From address | Sender address, e.g. noreply@yourcompany.com |
Click Send test email to verify the configuration before saving.
Common SMTP providers
| Provider | Host | Port | Secure |
|---|---|---|---|
| Gmail (App Password) | smtp.gmail.com | 587 | false |
| Gmail (SSL) | smtp.gmail.com | 465 | true |
| SendGrid | smtp.sendgrid.net | 587 | false |
| Mailgun | smtp.mailgun.org | 587 | false |
| AWS SES (eu-west-1) | email-smtp.eu-west-1.amazonaws.com | 587 | false |
| Postmark | smtp.postmarkapp.com | 587 | false |
| Mailhog (local dev) | localhost | 1025 | false |
myaccount.google.com → Security → App passwords.Trigger conditions
Notifications are driven per channel by two toggles:
| Condition | When it fires |
|---|---|
| On failure | An execution finishes with a non-zero exit code, is unreachable, or times out |
| On success | An execution completes successfully (exit code 0) |
Enable a channel with only on failure to be alerted about problems without noise from successful runs.
Notification email format
Subject: [SculptOps] Deploy app — failed (production)
Playbook: Deploy app
Inventory: production
Triggered by: alice@example.com
Started: 2025-01-15 10:31:00 UTC
Duration: 2m 14s
Status: FAILED (exit code 1)
Last 20 lines of output:
TASK [restart service] *****
fatal: [web1]: FAILED! => {"msg": "..."}
View full execution: https://your-instance/executions/exec789