# Notifications Tab

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

## SFDC Notifications

![](/files/aDAcNYVWuhsHPXLALrpE)

| 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><p>“{file}” will be replaced by the base name of the CopyStorm configuration file used by the job.</p><ul><li>For example, the configuration file “C:\capstorm\config\myCopyStormConfig.copyStorm” will be replaced with “myCopyStormConfig.copyStorm”.</li></ul></li></ul> |
| Send Notification On  | No       | <p>Determines when CopyStorm 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 recovered).</li></ul>                                                                                                                                                                                                                                                                                                                                                                               |
| Notify When Using GUI | No       | If checked, email notifications will be sent when CopyStorm is launched from the GUI. If not checked, email notifications will only be sent when CopyStorm runs in batch mode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Notify Current User   | No       | If checked, the Salesforce User specified on the Main tab of CopyStorm will be notified in addition to the specified recipients (Send Email To).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## SMTP Notifications

![](/files/2xJUV0qX8HUrIk9cyuT8)

| 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><p>“{file}” will be replaced by the base name of the CopyStorm configuration file used by the job.</p><ul><li>For example, the configuration file “C:\capstorm\config\myCopyStormConfig.copyStorm” will be replaced with “myCopyStormConfig.copyStorm”.</li></ul></li></ul> |
| Send Notification On  | No       | <p>Determines when CopyStorm 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 recovered).</li></ul>                                                                                                                                                                                                                                                                                                                                                                               |
| Notify When Using GUI | No       | If checked, email notifications will be sent when CopyStorm is launched from the GUI. If not checked, email notifications will only be sent when CopyStorm runs in batch mode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Require Encryption    | No       | If checked, CopyStorm will require that connections to the email server be encrypted with TLS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Email Report Format   | Yes      | A list of supported formats for the notification email.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Email User            | No       | Username used to authenticate with the SMTP server.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Email Password        | No       | Password used to authenticate with the SMTP server.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

## How to Test Email Delivery

The “Test Email Delivery” button causes an email to be sent to the recipient list. If communication to the SMTP email server or target Salesforce org is successful an acknowledgement dialog will be displayed and an email will be delivered to the recipients.

If communication to the SMTP email server or target Salesforce org fails, a dialog will be displayed showing the error. In this case you should show the error to your local administrator.

Test email notification:

![](/files/0H35wrwXXXRr5rWfKZrS)

## CopyStorm Notification Reports

Under normal circumstances CopyStorm will deliver a notification email that looks like the following. Note that this data is also stored in the CopyStorm database and can be browsed using CopyStorm/Medic (or any other tool you choose).

![](/files/nCppEW8GZde4wr5JPveU)

If CopyStorm encountered an error during the backup job, errors will be listed below this summary table:

![](/files/sz7XOEhFMSkFERSsD0NX)

If CopyStorm fails before any backup can be attempted, a notification email like the following will be sent. In this example the password for Salesforce was incorrect in the CopyStorm configuration file.

![](/files/yy3JepaV2Slgz3lVSsGW)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.capstorm.com/reference/notifications-tab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.