# Notifications

## Overview

Notifications for a Site and its Project backups are managed at the user level. This way, any Member within a Team can set personalized notification settings.

## Managing Email Addresses

To access your notification preferences use your profile setting.  Click the caret next to your avatar in the top nav and choose the *Settings* option.

![](https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FIyk8ctTpMC6eGeOreMC4%2FWebApp_UserSettings_02.png?alt=media\&token=ef80cff1-6bf6-4bbd-ad5a-7bcd81be8dec)

Choose the *Notifications* section and take note of the *General* container. By default, the email you used during registration will be set as the primary address to deliver notifications.

![](https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FuY9zasyNY2vYSjTbyZJu%2FWebApp_NotificationsScreen.png?alt=media\&token=91068584-ab60-4e98-a6b6-2561d22035f9)

{% hint style="info" %}
If you wish to send notifications to multiple email accounts, you can add additional email addresses within the *Add New Email Address* field. Notifications will be sent to all email accounts that are registered within the *General* container.
{% endhint %}

## Managing Preferences for DeviceLink

Notifications preferences are managed separately between Copia products.  In this section, we will review how to setup e-mail notifications for DeviceLink.  These notifications may be individual notifications, or contain summary reports over a defined period of time.

{% hint style="info" %}
Additional reports summarizing Job results can also be found directly, using [Site graphs](https://docs.copia.io/docs/devicelink/sitesandagents/sites/organization-dashboard).
{% endhint %}

### Enabling Email Notifications

To activate email notifications for DeviceLink, scroll down to the *Device Management* section and ensure that the *Enable Notifications* toggle is turned on.

![](https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FrjOLbnYr8ucNuFkHW8VQ%2FWebApp_DeviceLink_NotificationsOn.png?alt=media\&token=12fa1c8e-53b1-40a2-81b8-969ac935126e)

When you enable notifications for DeviceLink, you will receive notifications for Projects you've elected to "watch."

{% hint style="info" %}
To learn more about how to watch or unwatch a Project, check out the [Watching Projects](https://docs.copia.io/docs/devicelink/projects-and-devices#watching-projects)  section.
{% endhint %}

#### "Some backups did not start" Notifications

[Sitewide job schedules](https://docs.copia.io/docs/sitesandagents/sites/site-settings#sitewide-backup-schedule) allow you to back up all projects in a site with a single schedule configuration. As described in the sitewide schedule section:

> If the agent is unable to complete the backups before a new set of backup operations is scheduled (*e.g. because there were too many, or the agent went offline*), the site admins will receive an email letting them know. If the agent was online and running the whole time, this may mean you need additional agent capacity.

{% hint style="warning" %}
This "Some backups did not start" notification is **only** sent to users with DeviceLink notifications enabled.
{% endhint %}

### Notify Immediately

When this option is selected, Site activity that you set as important will be pushed as individual emails. You can choose to be notified for failed job runs, modified job runs, or both.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FNUqPjEmS3pUppR2oUqU3%2FWebApp_DeviceLink_Immediately.png?alt=media&#x26;token=838ef501-1b9b-41bb-9728-36459b2d961e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If your organization has set up [Copia Copilot commit descriptions](https://docs.copia.io/docs/copilot-for-devicelink), you can receive Copia DeviceLink commit descriptions in these email notifications.
{% endhint %}

### **Notify with Report at the End of Each Day**

When this option is selected, a summary report will be emailed each day at midnight in your Site's time zone.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2F5uEqZw9pgYZYMTtzTu3S%2FWebApp_DeviceLink_Day.png?alt=media&#x26;token=aeb44a10-c191-4fd7-86a2-6cdfff7e8512" alt=""><figcaption></figcaption></figure>

The email will provide a daily tally of Job results, organized by runs that were up to date, modified, or failed/timed out.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FJCNXPUXlo0oIQ20RbdCH%2FEmailReport_Daily_BarVertical.png?alt=media&#x26;token=a1a922c6-b9d6-4780-a594-6c24ec63718f" alt=""><figcaption></figcaption></figure>

### **Notify with Report at the End of Each Week**

When this option is selected, a summary report will be emailed each Sunday at midnight in your Site's time zone.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FLW3eRiDHpyH6CIkn2Bfn%2FWebApp_DeviceLink_Week.png?alt=media&#x26;token=4f5cf6d1-7c0c-4905-8a43-e95f4ef71051" alt=""><figcaption></figcaption></figure>

This email will provide a weekly tally of Job results, organized by runs that were up to date, modified, or failed/timed out.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FnvJgMLrcEfwbZZGQcckw%2FEmailReport_Weekly_BarVertical.png?alt=media&#x26;token=c9503171-2754-4e9c-bc51-27c46a891ee8" alt=""><figcaption></figcaption></figure>

Once you're finished with your selections, click the *Save Changes* button.

### Manually Generate a Report

In addition to scheduled reports, customers can manually generate a report for the sites that they are a member.  In the Send Job Run Report Now section, select the start and end dates, and press Send Job Run Report.  You will receive a summary email for each of your sites.

<figure><img src="https://3704730939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4lSQNVI3DZ15V7kjkMCA%2Fuploads%2FfH3Sm1apJIGZeGHdsY61%2FJobNotifications.png?alt=media&#x26;token=5ede99b3-ba1f-4977-9c25-7221c40ac58e" alt=""><figcaption></figcaption></figure>


---

# 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://docs.copia.io/docs/devicelink/administration/notifications.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.
