- Archive
- /
- Scheduled Jobs
- /
- Job Email Notifications
Job Email Notifications
Learn how to configure Foreman job email notifications to alert you when scheduled jobs complete or fail, including default settings and where to manage notification preferences.
Foreman can send you email notifications when your scheduled jobs complete or fail, so you stay informed without needing to check the dashboard. Each job has independent notification toggles that you can configure when creating or editing the job.
Notification Toggles
Every scheduled job has two notification settings:
| Toggle | Default | Description |
|---|---|---|
| Notify on complete | Off | Sends an email when the job finishes successfully. |
| Notify on failure | On | Sends an email when the job fails. |
Notify on failure is enabled by default for all new jobs. This ensures you are alerted to problems without needing to opt in. You can turn it off if you prefer to monitor jobs manually.
Where to Configure Notifications
You can set notification preferences in two places:
- Create dialog — when creating a new job from the Scheduled Jobs page or from a context-specific schedule dialog (Create Project Folders, Attribute Extracts), the notification toggles appear alongside the schedule picker.
- Inline edit dialog — click the edit icon (pencil) on any existing job to open the edit dialog, where you can update notification settings at any time.
Changes take effect immediately for the next execution.
Success Email Content
When a job completes successfully and Notify on complete is enabled, the email includes:
| Field | Example |
|---|---|
| Greeting | "Hi Sarah," (uses your first name if available, otherwise "Hi there,") |
| Job name | "Weekly folder validation — Project Alpha" |
| Job type | Folder Validation |
| Duration | 2 min 14 sec |
| Summary | "Validated 247 folders. 0 discrepancies found." |
| Link | Opens the job detail page in Foreman |
For Attribute Extract jobs, the link points to the Saved Extracts tab on the Attribute Extracts page so you can immediately download the generated file. For all other job types, the link opens the job detail page with execution history.
Failure Email Content
When a job fails and Notify on failure is enabled, the email includes:
| Field | Example |
|---|---|
| Greeting | "Hi Sarah," |
| Job name | "Daily permission sync — Project Beta" |
| Job type | Permission Application |
| Error details | "HTTP 403: Access denied. Your account no longer has admin access to this project." |
| Link | Opens the job detail page in Foreman |
When a job is auto-disabled due to a non-retryable error (403, 404, or inactive project), the failure email includes an additional warning: "This job has been automatically disabled to prevent repeated failures. Re-enable it from the Scheduled Jobs page after resolving the issue."
Auto-Disable Warning
If Foreman auto-disables a job due to a non-retryable error, the failure notification email clearly states that the job has been disabled and explains why. This prevents you from being flooded with repeated failure emails for a problem that requires manual intervention.
The email includes:
- The specific error that triggered the auto-disable (e.g. HTTP 403, project archived)
- A direct link to the job detail page where you can investigate and re-enable
- Guidance on common fixes (re-authenticate, check project status, verify permissions)
Greeting Personalisation
Email greetings use your first name when available from your Autodesk profile (e.g. "Hi Sarah,"). If no first name is set on your account, the greeting falls back to "Hi there,".
Enable Notify on complete for critical jobs like weekly member audit snapshots so you have positive confirmation that the job ran, not just alerts when something goes wrong.