> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Notification preferences

> Choose which Flowella events deliver to your in-app feed and email inbox, manage digests, and review which alerts are mandatory for security and billing.

<Frame>
  <img src="https://mintcdn.com/flowella/PuGNWwHHg6Nlq3MM/images/Screenshots/flowella-notification-preferences.png?fit=max&auto=format&n=PuGNWwHHg6Nlq3MM&q=85&s=91d3ed2a14b83c12a5d2b093ffbd6b97" alt="Flowella notification preferences" width="2774" height="1686" data-path="images/Screenshots/flowella-notification-preferences.png" />
</Frame>

Notification preferences let you tune which Flowella events show up in your in-app feed and which arrive by email. Preferences are **per-user**, not per-organisation — each user manages their own.

For the full list of events Flowella can emit, see [Notification events](/app/notification-events). For the in-app feed itself, see [Notifications](/app/notifications).

## Opening Settings → Notification preferences

From the left navigation, go to **Settings → Notifications**.

## How preferences are structured

Preferences are grouped by **category**.

<CardGroup cols={2}>
  <Card title="Account & authentication" icon="shield-check">
    Sign-in, password changes, new-device alerts.
  </Card>

  <Card title="Billing & usage" icon="badge-dollar-sign">
    Invoices, trial lifecycle, usage thresholds.
  </Card>

  <Card title="Templates" icon="file-text">
    Submission, approval, rejection, re-categorisation.
  </Card>

  <Card title="WhatsApp Flows & forms" icon="layout-template">
    Sync results, publish events.
  </Card>

  <Card title="HubSpot integration" icon="plug">
    Connection state, sync failures.
  </Card>

  <Card title="Channels & Meta" icon="message-circle">
    Channel connections, verification, quality drops.
  </Card>

  <Card title="Exports & imports" icon="download">
    Long-running job completion.
  </Card>
</CardGroup>

Inside each category, every event has two toggles:

* **In-app** — shows in the bell icon feed at `/notifications`.
* **Email** — sends to your verified profile email.

Toggle each independently. Changes save automatically.

## Mandatory categories

<Warning>
  Some categories cannot be disabled. The toggles are still shown so you can see they exist, but they're greyed out with an explanation.
</Warning>

| Category                                                                               | Why it's mandatory                                                                              |
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Authentication (`AUTH_*`)                                                              | Security. You always need to know about password changes, magic links, and new-device sign-ins. |
| Billing operational (`BILLING_PAYMENT_FAILED`, `BILLING_SUBSCRIPTION_CANCELLED`, etc.) | Org continuity. Missing a failed payment can interrupt service.                                 |
| Usage hard cap (`USAGE_HARD_100`)                                                      | Service quality. You need to know when overage applies or, on trial, when sends are blocked.    |

Other categories — usage soft alerts, template lifecycle events, HubSpot sync events — are optional.

## Org-wide operational email

Some org-level events (failed payments, subscription cancellation, trial expiry) are delivered both to **your personal email** and to a **single org-wide operational address**. The org-wide address is configured separately:

**Settings → Organisation → Notifications email**

Set this to your billing or operations team alias so critical events reach someone even when individual users are out of office.

## Daily reminder sweep

Flowella runs a daily sweep that re-surfaces high-impact unread notifications — for example, an unread `TEMPLATE_REJECTED` or `HUBSPOT_SYNC_FAILED` that has been sitting for more than 24 hours. The sweep respects your preferences: if you've turned off email for that category, the reminder is in-app only.

You cannot disable the sweep itself, but you can disable individual category reminders by turning off the underlying event.

## Quiet hours and digests

There is currently **no quiet-hours or digest mode** — every triggered notification is delivered immediately on the channels you've enabled. If you need to silence Flowella outside business hours, the practical workaround is to filter the `notifications@flowella.io` sender into a folder in your email client.

Quiet hours and a daily digest mode are on the product roadmap.

## Common questions

<AccordionGroup>
  <Accordion title="Why didn't I receive an email?">
    Most often: your profile email is unverified, or the message landed in spam. Check **Settings → Profile** for the verification status, and search your spam folder for `notifications@flowella.io`. If the email is verified and not in spam, check whether the event's email toggle is on.
  </Accordion>

  <Accordion title="Can I subscribe other people to my notifications?">
    No — preferences are strictly per-user. If you want a teammate to receive an event, they need to be a member of the org with the relevant role and they manage their own preferences.
  </Accordion>

  <Accordion title="What happens to my preferences if I'm in two organisations?">
    Preferences apply across every org you're a member of. There is no per-org override yet. Roadmap.
  </Accordion>

  <Accordion title="How do I find out which events are available?">
    See [Notification events](/app/notification-events) for the full catalogue with payload shapes.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Notification events" icon="list" href="/app/notification-events">
    The full catalogue of events with channels and mandatory flags.
  </Card>

  <Card title="Notifications feed" icon="bell" href="/app/notifications">
    The in-app feed these preferences control.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/settings/webhooks">
    Push the same events to your own systems instead.
  </Card>

  <Card title="Profile" icon="user" href="/settings/profile">
    Verify your email address to receive notification emails.
  </Card>
</CardGroup>
