---
title: "Read your notification settings"
description: "Which kinds of email OpenEmail sends the person, and the workspaces muted on their phone."
url: "https://openemail.uk/docs/api/account/notifications"
area: "API"
category: "Your account"
---

# Read your notification settings

Which kinds of email OpenEmail sends the person, and the workspaces muted on their phone.

`GET /account/notifications`

## GET /account/notifications

Which kinds of email OpenEmail sends the person, and the workspaces muted on their phone.

## Example

Needs `account:read`. `email` has a row for each kind: `account` and `billing`, which are always on, then `activity` and `product`, which can be turned off.

**curl**

```
curl "$OE/account/notifications" -H "$AUTH"
```

**Response**

```
{
  "object": "notification_settings",
  "email": [
    { "category": "account", "label": "Account", "description": "Sign-in and security notices, invitations, and changes to your workspaces such as API keys, webhooks, domains and members.", "required": true, "enabled": true },
    { "category": "billing", "label": "Billing", "description": "Receipts, renewals, refunds, plan changes and payments that need attention.", "required": true, "enabled": true },
    { "category": "activity", "label": "Activity", "description": "Your daily AI actions running out and coming back, a monthly usage summary, and a note when your mailbox sits unread.", "required": false, "enabled": true },
    { "category": "product", "label": "Product news", "description": "Occasional notes about what is new in OpenEmail.", "required": false, "enabled": false }
  ],
  "mutedWorkspaces": []
}
```

> These calls act on a person, not on a workspace. An API key acts for the owner of the workspace it belongs to, and an app for the person who connected it. Reading needs `account:read` and every change `account:write`, and no role limits either.

## Reference

- [`GET /account/notifications`](https://openemail.uk/docs/api/reference/your-account#get-account-notifications): full reference
