---
title: "Notifications"
description: "Notices EZGH Cloud sends about your organization's resources, and who gets them by email."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

A notice is a message from EZGH Cloud about one of your organization's resources: a Kubernetes
version reaching end of support, a domain renewal that failed. Each notice is emailed to the
organization's contacts for its category and kept in the console's inbox.

In the console, open **Notifications**. The **Inbox** tab lists notices, newest first; a notice's
page shows what it says, the resource it's about and each email sent for it. The **Settings** tab
holds the contacts and muted notice types. Notices and settings belong to the organization, not to
a project.

## Categories

Every notice type has one category:

| Category | For |
| --- | --- |
| Operations | End of support, maintenance and other changes to your resources |
| Billing | Payments and renewals |
| Security | Abuse and security issues involving your resources |

## Contacts

Each category has up to 10 contact email addresses. Add them on the **Settings** tab, or with
`ezgh notifications settings set`.

A new address is sent an email with a link to confirm it. The link works once, for 7 days. Until
the address confirms, it gets no notices; the console shows it as **Unconfirmed**. Saving the
settings again sends a new link to an unconfirmed address whose link expired. An address is sent
at most one confirmation email per category a day.

Emails come from `notifications@mail.ezghcloud.com`.

## When a category has no contacts

A category with no confirmed contacts sends its notices to the organization's
[root user](/organizations#the-root-user). Billing notices go to the billing contact in **Billing** > **Billing
details** first, then to the root user.

When every contact's email fails, the notice is sent to the root user once.

## Notice types

| Type | Category | Required | Sent when |
| --- | --- | --- | --- |
| `kubernetes.endOfSupport` | Operations | Yes | A cluster's Kubernetes version reaches end of support |
| `domains.renewalFailed` | Billing | Yes | A domain's renewal failed |

## Muting notice types

Notice types are required or informational. Required types are always emailed and can't be muted.
You can mute an informational type on the **Settings** tab: its notices still appear in the inbox,
and nobody is emailed.

## Unsubscribing

Every email to a contact has an **Unsubscribe** link, which removes that address from that
category's contacts. Emails to the root user don't.

## Deliveries

A notice's page lists each email:

| Status | Meaning |
| --- | --- |
| Pending | Not sent yet, or being retried |
| Sent | Accepted for delivery |
| Failed | Not delivered after 24 hours of retries, or refused |
| Undeliverable | The organization had nobody to send it to |

## Retention

Notices are kept for 13 months. Deleting a project deletes its notices; deleting the organization
deletes all of them and the settings.

## Permissions

| Action | Allows |
| --- | --- |
| `notifications.notices.list` | Listing notices and notice types |
| `notifications.notices.get` | Reading a notice and its deliveries |
| `notifications.settings.get` | Reading contacts and muted types |
| `notifications.settings.update` | Changing them |

`NotificationsFullAccess` grants all four; `NotificationsReadOnlyAccess` grants the reads.

## CLI

```sh
ezgh notifications list --category billing
ezgh notifications get ntc_3h5j7k9m1n2p
ezgh notifications settings get -o json > settings.json
ezgh notifications settings set -f settings.json
```

`settings set` replaces the whole document. If the settings changed after `ezgh` read them,
nothing is saved. See [`ezgh notifications`](/cli/reference/notifications) for every command.

## API

Notifications is at `https://notifications.ezghcloud.com`. See the
[Notifications API reference](/notifications-api).

Source: https://docs.ezghcloud.com/notifications/index.mdx
