> For the complete documentation index, see [llms.txt](https://learn.capstorm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.capstorm.com/reference/copystorm-medic/notifications.md).

# Notifications

The Notifications Tab contains parameters used to control who receives a status email when a CopyStorm/Medic job runs and under what circumstances email is sent. CopyStorm/Medic supports email notifications via SMTP or via a Salesforce SOAP API call.

## SFDC Notifications

![](https://4057376488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsbSqfKw3vSfr8qwXao4j%2Fuploads%2Fgit-blob-b1ac6becec0f9701b41bab6c70b1ad2e15452c0b%2F3a4bedbe-MEDICsfdcEmailNotifications.jpg?alt=media)

| Parameter Name       | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Send Email To        | Yes      | Notification emails will be sent to this white space separated list of email addresses.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Subject              | Yes      | <p>The subject line used for notification emails. Though it can be any text you want, there are a few special text values that will be replaced dynamically before a message is sent:</p><ul><li><p>“{status}” will be replaced by “OK” or “ERROR” based on the outcome of the job.</p><ul><li>If there are any exceptions encountered then “ERROR” will be substituted, otherwise “OK” will be used.</li></ul></li><li>“{application}” will be replaced by “CopyStorm/Medic”.</li><li><p>“{file}” will be replaced by the base name of the CopyStorm/Medic configuration file used by the job.</p><ul><li>For example, the configuration file “C:\capstorm\config\myCopyStormMedicConfig.copyStormMedic” will be replaced with “myCopyStormMedicConfig.copyStormMedic”.</li></ul></li></ul> |
| Send Notification On | No       | <p>Determines when CopyStorm/Medic will send a notification email:</p><ul><li>Success: If checked, an email will be sent if a job works perfectly (no exceptions).</li><li>Exception(s): If checked, an email will be sent if a job has any exception (including non-fatal exceptions where CopyStorm/Medic recovered).</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Notify Current User  | No       | If checked, the Salesforce User specified on the Main tab of CopyStorm/Medic will be notified in addition to the specified recipients (Send Email To).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

## SMTP Notifications

![](https://4057376488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsbSqfKw3vSfr8qwXao4j%2Fuploads%2Fgit-blob-be84a2311e4b593808db45ab9c7bd634dd4c9780%2Ff05be95d-MEDICsmtpEmailNotifications.jpg?alt=media)

| Parameter Name       | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Email Host           | Yes      | The SMTP host used by your organization (used to send email). If you do not know this information ask your email administrator.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Email From           | Yes      | The email address that will appear in the “From” field in sent notifications. Note that many email servers allow this value to be a fake email address (e.g. “<noreply@capstorm.com>”).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Send Email To        | Yes      | Notification emails will be sent to this white space separated list of email addresses.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Subject              | Yes      | <p>The subject line used for notification emails. Though it can be any text you want, there are a few special text values that will be replaced dynamically before a message is sent:</p><ul><li><p>“{status}” will be replaced by “OK” or “ERROR” based on the outcome of the job.</p><ul><li>If there are any exceptions encountered then “ERROR” will be substituted, otherwise “OK” will be used.</li></ul></li><li>“{application}” will be replaced by “CopyStorm/Medic”.</li><li><p>“{file}” will be replaced by the base name of the CopyStorm/Medic configuration file used by the job.</p><ul><li>For example, the configuration file “C:\capstorm\config\myCopyStormMedicConfig.copyStormMedic” will be replaced with “myCopyStormMedicConfig.copyStormMedic”.</li></ul></li></ul> |
| Send Notification On | No       | <p>Determines when CopyStorm/Medic will send a notification email:</p><ul><li>Success: If checked, an email will be sent if a job works perfectly (no exceptions).</li><li>Exception(s): If checked, an email will be sent if a job has any exception (including non-fatal exceptions where CopyStorm/Medic recovered).</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Require Encryption   | No       | If checked, CopyStorm/Medic will require that connections to the email server be encrypted with TLS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Email User           | No       | Username used to authenticate with the SMTP server.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Email Password       | No       | Password used to authenticate with the SMTP server.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |