# Choose who gets workspace notifications

Workspace notifications are emails Faustine sends to members when something happens in the workspace, such as an analysis that finished or a connection that keeps failing. You set them per event in **Settings** > [**Notifications**](https://auth.faustine.ai/go?to=%2Fsettings%3Ftab%3Dnotifications). Any member can change them.

## Events

| Group | Event | Sent when | On by default |
| --- | --- | --- | --- |
| Analysis | **Analysis started** | An analysis of a Web Agent or an API was queued or started. | No |
| Analysis | **Analysis needs attention** | An analysis is waiting for someone to pick the modules to generate. | Yes |
| Analysis | **Analysis completed** | The draft is ready to review. | Yes |
| Analysis | **Analysis failed** | An analysis failed, was interrupted or was cancelled. | Yes |
| Code changes | **Update started** | A push or a manual check started an update run. | No |
| Code changes | **Update completed** | An update changed the draft or published a version. | Yes, only breaking |
| Code changes | **Update with no impact** | A check found nothing to change. | No |
| Code changes | **Update failed** | An update run failed or was interrupted. | Yes |
| Versions | **Version published** | A Web Agent or API version was published, by a person or by an update. | Yes |
| Domains | **Domain ready** | Your custom domain was verified or is serving again. | Yes |
| Domains | **Domain problem** | Your custom domain is misconfigured or stopped being served. | Yes |
| Connections | **Connection degraded** | An API connection keeps failing to sign in to your API. | Yes |
| Connections | **Connection recovered** | A degraded connection signs in again. | Yes |
| Recipes & tests | **Recipes proposed** | An analysis or an import proposed new recipes on an API. | No |
| Recipes & tests | **Test generation failed** | A test suite could not be generated. | No |

The two "started" events are not sent to the person who started the run.

## Set an event's recipients

To change who receives an event:

1. In the portal, go to **Settings** > [**Notifications**](https://auth.faustine.ai/go?to=%2Fsettings%3Ftab%3Dnotifications).
2. Turn the event's switch on.
3. Select who receives it:
    - **Everyone** sends it to every member, including people who join later.
    - **Selected** sends it to the people you pick. Select **Add person** and choose at least one member.
4. For **Update completed** and **Version published**, select **Only breaking changes** to send the email only when the change is breaking.

Each change saves when you make it. A row that differs from the default shows **Reset**, which puts it back.

## Send a test

To see what an event's email looks like, select **Send test** in its row. Faustine sends a sample of that event to your address only, whether the event is on or off. The row shows **Test email: Sent to** and your address.

## Stop the emails for yourself

A member can stop every notification email from a workspace without changing the workspace's rules. Turn off **Email notifications from this workspace** in [your profile](https://docs.faustine.ai/workspace/profile/), or use the unsubscribe link in any notification email. Invitations and password resets still arrive.

## Limits

| Limit | Value |
| --- | --- |
| Notification emails per workspace | 100 per hour. Above that, Faustine pauses notifications and sends one notice that says so. |

## Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| **Pick at least one person.** | **Selected** has nobody in it. | Add a person, or select **Everyone**. |
| A member receives nothing | They turned off **Email notifications from this workspace** or unsubscribed. | They turn it on again in their profile. |

## Next steps

- [Change your profile and password](https://docs.faustine.ai/workspace/profile/): your own switch for this workspace's emails.
- [Monitoring](https://docs.faustine.ai/workspace/monitoring/): the same events as a feed in the portal.
- [Invite people to your workspace](https://docs.faustine.ai/workspace/invite-people/): add the people who should be notified.
