Notifications
Configuring email notifications for playbook and workflow execution events.
Overview
SculptOps can send email notifications when executions complete, fail, or time out. Notifications are configured at the organization level and can be further customized per-user.
SMTP setup
Go to Settings → Notifications → SMTP and fill in your mail server details. You can also set these via environment variables — UI settings take precedence.
| Field | Env variable | Description |
|---|---|---|
| Host | SMTP_HOST | SMTP server hostname |
| Port | SMTP_PORT | Usually 587 (STARTTLS) or 465 (TLS) |
| Secure (TLS) | SMTP_SECURE | Enable for port 465 |
| Username | SMTP_USER | SMTP auth username |
| Password | SMTP_PASS | SMTP auth password (stored encrypted) |
| From address | SMTP_FROM | 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 |
Tip
For Gmail, you must use an App Password (not your account password) if 2FA is enabled. Generate one at
myaccount.google.com → Security → App passwords.Notification events
Admins configure which events trigger notifications under Settings → Notifications → Events:
| Event | Description |
|---|---|
| Execution failed | Any playbook or workflow step exits with a non-zero code |
| Execution timed out | Execution killed by the ANSIBLE_EXECUTION_TIMEOUT limit |
| Execution succeeded | Playbook or workflow completes with exit code 0 |
| Schedule missed | A scheduled run was skipped due to a previous run still running |
Per-user notification preferences
Each user can opt in or out of notifications from their profile under Profile → Notifications. Users can choose:
- Notify on executions I triggered
- Notify on all executions in the organization
- Only notify on failures
Notification email format
text
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