# Choose which emails you get

> Turn optional emails from Coritan on or off in Settings or from the email itself, and see which emails always arrive.

Source: https://www.coritan.com/docs/account/notifications/

In the dashboard:

- /dashboard/settings/notifications: https://www.coritan.com/dashboard/settings/notifications

The **Notifications** tab of **Settings** lists the kinds of email Coritan sends to your [sign-in email](/docs/account/change-email/). You can turn off the optional kinds there, or with the link at the bottom of an optional email. Security and billing emails always arrive.

## Before you begin

- To use the Notifications tab, sign in to the [dashboard](https://www.coritan.com/dashboard). The link in an email works without signing in.

## Turn a kind of email on or off

1. In the sidebar, select **Settings**, then the **Notifications** tab.
2. On the **Email notifications** card, select the switch beside a kind of email.

Each change saves at once, and a message confirms it, such as `Offers and news turned on.`

## Unsubscribe from an email

Every email of an optional kind ends with a link that turns that kind off.

1. In the email, open the unsubscribe link at the bottom.
2. The page names the kind of email and the address we send it to. Select **Unsubscribe**.

The page then says `You are unsubscribed`, and we stop sending that kind of email to your account. Opening the link changes nothing on its own, so a mail app that opens links to check them cannot unsubscribe you.

Some mail apps show their own unsubscribe button beside the sender's name. It turns off the same kind of email in one step, without the page.

The link turns off one kind of email for one account. To turn it back on, use the Notifications tab.

## Choose offers and news when you sign up

The sign-up form has a box, **Email me offers and news**, that starts unticked. Tick it to get **Offers and news** from the start. If you leave it unticked, your new account gets none, and you can turn them on later on the Notifications tab.

## The kinds of email

| Kind | What it covers | A new account |
| --- | --- | --- |
| **Product updates** | New features and changes in the products you use. | On |
| **Usage alerts** | When a service comes close to a limit of its plan, such as its storage or its traffic. | On |
| **Offers and news** | New products, offers and the occasional newsletter. | Off |
| **Security** | Changes to your password, sign-in email, API keys or two-factor authentication. | Always on |
| **Billing** | Invoices, receipts, failed payments and renewals. | Always on |

The switches for **Security** and **Billing** stay on, because those emails tell you about something you may need to act on.

## When each email goes

These emails follow your account from sign-up. Each one goes once for the event it is about.

| Email | When we send it | Kind |
| --- | --- | --- |
| Welcome | When you create an account. | Always sent |
| Getting started | One, three and seven days after you sign up. Each links the guide for the first of servers, websites, email and storage that you have not started. | Product updates |
| Setup reminder | Three days after you sign up, in place of that day's guide, if you have not started anything yet. | Product updates |
| Usage warning | When your [plan's](/docs/billing/account-plans/) allowance of websites, load balancers, mail domains, mailboxes or Object Storage is 80% used. Once per allowance in each billing period. | Usage alerts |
| Allowance used up | When one of those allowances is all used. Once per allowance in each billing period. | Usage alerts |
| Account still open | A week after your last paid service ends, if you pay for nothing and owe nothing. At most once in 90 days. | Offers and news |
| Referral link | After you pay your first invoice, with your [referral link](/docs/account/referrals/), unless Coritan has switched referrals off. | Offers and news |
| Trial reminders | Four days and one day before a plan's trial ends, and when it ends. | Billing |
| Card expiring | When the card you pay with expires this month or next. | Billing |
| Renewal reminder | About 30 days before a service billed every year or every two years renews. | Billing |

Emails about your invoices, receipts and failed payments are **Billing** too.

## Result

Your choices apply to your account only. A [team member](/docs/account/team-members/) chooses their own emails in their own account.

## Troubleshooting

**Could not load your email notifications**
: The tab could not read your choices. Select **Try again**.

A switch moves back after you select it
: The change did not save, and a message gives the reason. Try again.

The unsubscribe page says `This link doesn't work`
: The link is incomplete or was changed on its way to you. Open the email again and use its whole link, or turn the kind off on the Notifications tab.

The unsubscribe page says the emails are already off
: That kind was already off for your account, and nothing changed.

The unsubscribe page says `We could not find this account`
: The account the email was for is closed, and we no longer send it email.

## Related

- [Change your sign-in email](/docs/account/change-email/)
- [Update your profile](/docs/account/profile/)
- [Invite people to your referral link](/docs/account/referrals/)

## With the API

These routes are about the person signed in, so they ignore the `X-Coritan-Account` header.

[`GET /auth/me/notifications`](/docs/api/reference/client/account-settings/#op-get-api-v1-auth-me-notifications) answers every kind, with `true` for the ones you get:

```bash
curl https://api.coritan.com/api/v1/auth/me/notifications \
  -H "Authorization: Bearer $CORITAN_TOKEN"
```

```json
{
  "marketing": false,
  "product_updates": true,
  "usage_alerts": true,
  "security": true,
  "billing": true
}
```

`marketing` is **Offers and news**. `security` and `billing` are always `true`.

[`PUT /auth/me/notifications`](/docs/api/reference/client/account-settings/#op-put-api-v1-auth-me-notifications) changes the kinds you send, and a kind you leave out keeps its value. The answer is every kind, as above.

```bash
curl -X PUT https://api.coritan.com/api/v1/auth/me/notifications \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"marketing": true}'
```

Sending `"security": false` or `"billing": false` answers `422`, and the error for that field says `Value error, Security and billing emails are always sent.`

### The unsubscribe link

An optional email carries the same link twice: at the bottom of the email, and in its `List-Unsubscribe` header with `List-Unsubscribe-Post: List-Unsubscribe=One-Click`, so a mail app can unsubscribe in one step. The link needs no sign-in. Its `token` names one account and one kind of email, and nothing else.

[`GET /email/unsubscribe`](/docs/api/reference/client/email-preferences/#op-get-api-v1-email-unsubscribe) answers the page with the **Unsubscribe** button, and changes nothing. Ask for JSON to read what the token names instead:

```bash
curl "https://api.coritan.com/api/v1/email/unsubscribe?token=$TOKEN" \
  -H "Accept: application/json"
```

```json
{
  "category": "marketing",
  "label": "Offers and news",
  "subscribed": true,
  "email": "a***@e***.com"
}
```

[`POST /email/unsubscribe`](/docs/api/reference/client/email-preferences/#op-post-api-v1-email-unsubscribe) turns that kind off. It answers JSON unless the request asks for a page:

```bash
curl -X POST "https://api.coritan.com/api/v1/email/unsubscribe?token=$TOKEN" \
  -d "List-Unsubscribe=One-Click"
```

```json
{
  "ok": true,
  "category": "marketing",
  "label": "Offers and news",
  "changed": true
}
```

`changed` is `false` when the kind was off already. A token we did not sign answers `400`, and a token for a closed account answers `404`.

## API

- `GET /api/v1/auth/me/notifications`: Which optional emails the account gets (https://www.coritan.com/docs/api/reference/client/account-settings/#op-get-api-v1-auth-me-notifications)
- `PUT /api/v1/auth/me/notifications`: Turn optional emails on or off (https://www.coritan.com/docs/api/reference/client/account-settings/#op-put-api-v1-auth-me-notifications)
- `GET /api/v1/email/unsubscribe`: What an email's unsubscribe link will turn off (https://www.coritan.com/docs/api/reference/client/email-preferences/#op-get-api-v1-email-unsubscribe)
- `POST /api/v1/email/unsubscribe`: Turn off the kind of email the token names, for its account only (https://www.coritan.com/docs/api/reference/client/email-preferences/#op-post-api-v1-email-unsubscribe)