Filtering Notification Emails

Every notification Runner sends carries custom headers — X-NodePit-Runner-Notification-Reason, X-NodePit-Runner-Project-Id, and others listed in Notifications. Most desktop mail clients can filter on these directly, even though they aren't shown by default. This guide sets up a filter that moves all run-status emails into a dedicated folder, using Thunderbird, Outlook, and Apple Mail as examples.

Thunderbird

1. Go to Tools → Message Filters and click New.
2. Under if the following conditions are met, open the first dropdown and choose Customize….
3. Add a new header named X-NodePit-Runner-Notification-Reason and select it from the condition dropdown.
4. Set the comparison to contains and enter run-status.
5. Under Perform these actions, choose Move Message to and pick or create a folder.
6. Save the filter. It applies to new mail from now on — use Run Filters Now on an existing folder to apply it retroactively.

Outlook

1. Go to Home → Rules → Manage Rules & Alerts and click New Rule.
2. Choose Apply rule on messages I receive and click Next.
3. Check with specific words in the message header, then click the specific words link in the description pane.
4. Enter X-NodePit-Runner-Notification-Reason: run-status and click Add, then OK.
5. Choose an action, such as move it to the specified folder, and finish the wizard.

Apple Mail

1. Go to Mail → Settings… → Rules and click Add Rule.
2. Name the rule, then open the first condition's dropdown and choose Other Header….
3. Enter X-NodePit-Runner-Notification-Reason as the header name, set the comparison to Contains or Is equal to, and enter run-status as the value.
4. Under Perform the following actions, choose Move Message and select a mailbox.
5. Click OK to save.

Going further

Combine headers for finer-grained routing — for example, a rule matching X-NodePit-Runner-Notification-Reason: run-status together with X-NodePit-Runner-Project-Id: <your-project-id> files run notifications per project instead of into one shared folder. Find a project's ID in its URL in the Runner web app.

If your mail client isn't listed here, check its documentation for filtering on a "custom header" or "message header" condition — the concept is the same, only the menu names differ. See Notifications for the full list of headers and when each is set.