Notification events

Flowella sends notifications when something important happens in your workspace — a template gets approved, you’re approaching a usage threshold, a HubSpot sync fails, or a teammate accepts an invite. This page catalogues every event Flowella can emit, where it shows up, and how to manage your preferences. For the in-app notifications feed itself, see Notifications. For notification preferences UI, see Settings → Notification preferences.

How notifications are delivered

Notifications can land in up to three places:

Channel	Where it appears	Customisable
In-app feed	Bell icon, top right — `/notifications`	Per category (most events)
Email	The email address on your Flowella user profile	Per category (most events)
Operational email	The org’s billing email	Always on for billing/security

Each event below shows which channels deliver it by default.

Event catalogue

Account & authentication

Event key	Description	Channels	Optional?
`WELCOME`	Sent immediately after you register a Flowella account. Confirms signup and links to onboarding.	In-app + email	No
`AUTH_PASSWORD_CHANGED`	Your password was changed.	In-app + email	No — mandatory
`AUTH_MAGIC_LINK_REQUESTED`	A magic-link sign-in was requested for your account.	Email only	No — mandatory
`AUTH_NEW_DEVICE`	A new device or location signed in.	In-app + email	No — mandatory
`ORG_INVITE_ACCEPTED`	Someone you invited accepted and joined the org.	In-app	Yes

Authentication and security events cannot be unsubscribed from. This is enforced server-side regardless of your notification preferences.

Billing & usage

Event key	Description	Channels	Optional?
`BILLING_SUBSCRIPTION_STARTED`	A new subscription was activated for the org.	In-app + operational email	Operational always on
`BILLING_SUBSCRIPTION_CHANGED`	Plan was upgraded or downgraded.	In-app + operational email	Operational always on
`BILLING_PAYMENT_FAILED`	Stripe could not charge the card on file.	In-app + operational email	Operational always on
`BILLING_PAYMENT_RECOVERED`	A failed payment succeeded on retry.	In-app + operational email	Operational always on
`BILLING_SUBSCRIPTION_CANCELLED`	The subscription has been cancelled and will end at the period close.	In-app + operational email	Operational always on
`BILLING_TRIAL_STARTED`	The 14-day free trial was provisioned at signup.	In-app + email	Yes
`BILLING_TRIAL_ENDING`	The 14-day trial ends in less than 72 hours.	In-app + email	Yes
`BILLING_TRIAL_EXPIRED`	The trial window has closed.	In-app + operational email	Operational always on
`USAGE_SOFT_50`	You have used 50% of your plan’s monthly conversation allowance (or your trial’s 5,000-message cap).	In-app + email	Yes
`USAGE_SOFT_80`	You have used 80% of your plan’s monthly allowance.	In-app + email	Yes
`USAGE_HARD_100`	You have used 100% of your plan’s monthly allowance — overage applies (or, on trial, sends are now blocked).	In-app + operational email	Operational always on

Templates

Event key	Description	Channels	Optional?
`TEMPLATE_SUBMITTED`	A template was submitted to Meta for approval.	In-app	Yes
`TEMPLATE_APPROVED`	Meta approved a template.	In-app + email	Yes
`TEMPLATE_REJECTED`	Meta rejected a template. The notification includes Meta’s rejection reason.	In-app + email	Yes
`TEMPLATE_FLAGGED`	Meta paused a template due to quality issues.	In-app + email	Yes
`TEMPLATE_PAUSED`	Meta transitioned a template into `PAUSED`. Sends from journeys, campaigns, and HubSpot actions using it are blocked until Meta restores it. Surfaces as the Paused by WhatsApp pill on the templates list.	In-app + email	Yes
`TEMPLATE_DISABLED`	Meta transitioned a template into `DISABLED`. The template must be updated or replaced before sending again. Surfaces as the Disabled by WhatsApp pill on the templates list.	In-app + email	Yes
`TEMPLATE_QUALITY`	Meta’s quality score for a template dropped to `RED`. Surfaces as the Quality: Red pill on the templates list.	In-app + email	Yes
`TEMPLATE_CATEGORY_CHANGED`	Meta re-categorised a template (for example, Marketing → Utility).	In-app + email	Yes

WhatsApp Flows & forms

Event key	Description	Channels	Optional?
`FLOW_SYNC_SUCCEEDED`	A HubSpot form was successfully synced to a WhatsApp Flow.	In-app	Yes
`FLOW_SYNC_FAILED`	A sync run failed. The notification includes the user-safe error message.	In-app + email	Yes
`FLOW_PUBLISHED`	A Flow was published to Meta.	In-app	Yes

HubSpot integration

Event key	Description	Channels	Optional?
`HUBSPOT_CONNECTED`	HubSpot OAuth completed.	In-app	Yes
`HUBSPOT_DISCONNECTED`	HubSpot connection was lost or revoked.	In-app + email	Yes
`HUBSPOT_SYNC_FAILED`	A scheduled HubSpot sync run failed.	In-app + email	Yes

Channels & Meta

Event key	Description	Channels	Optional?
`CHANNEL_CONNECTED`	A new WhatsApp channel was added.	In-app	Yes
`META_VERIFICATION_REQUIRED`	The channel needs business verification before it can send.	In-app + email	Yes
`META_VERIFICATION_COMPLETED`	Business verification completed.	In-app	Yes
`QUALITY_RATING_DROP`	Channel quality rating dropped to Medium or Low.	In-app + email	Yes

Exports & long-running jobs

Event key	Description	Channels	Optional?
`EXPORT_READY`	A CSV/PDF export you triggered is ready to download.	In-app	Yes
`IMPORT_COMPLETED`	A CSV import (for example, opt-outs) finished.	In-app	Yes

Operational sweeps

Flowella runs a daily notification reminders sweep. If an unread TEMPLATE_REJECTED, HUBSPOT_SYNC_FAILED, or BILLING_PAYMENT_FAILED notification has been sitting for more than 24 hours, the sweep re-surfaces it with an email reminder. This means you can’t silently miss a critical event by closing the bell icon.

Where to manage your preferences

Per-user, per-category — Settings → Notification preferences. Each category above can be toggled for in-app, email, or both, with the exception of mandatory categories (auth, billing operational).
Per-org operational email — Settings → Organisation → Notifications email. This is the recipient for billing, security, and other org-wide operational mails.

If you’re not receiving emails you expect, first check Settings → Profile that your email address is verified, then check your spam folder for messages from notifications@flowella.io. Unverified emails do not receive notifications.

Notification preferences

Choose which categories deliver in-app, by email, or both.

Notifications feed

Read and clear notifications in-app.

Webhooks

Push the same events to your own systems.

Status and incidents

Operational events and where to triage when something breaks.

Get Started

Changelog

Essentials

Using the App

Settings

Meta & WhatsApp Setup

HubSpot Integration

Flows & Campaigns

Account & Sign-in

Security & Privacy

API Reference

Troubleshooting

Notification events

How notifications are delivered

Event catalogue

Account & authentication

Billing & usage

Templates

WhatsApp Flows & forms

HubSpot integration

Channels & Meta

Exports & long-running jobs

Operational sweeps

Where to manage your preferences

Notification preferences

Notifications feed

Webhooks

Status and incidents

​How notifications are delivered

​Event catalogue

​Account & authentication

​Billing & usage

​Templates

​WhatsApp Flows & forms

​HubSpot integration

​Channels & Meta

​Exports & long-running jobs

​Operational sweeps

​Where to manage your preferences

​Related

Notification preferences

Notifications feed

Webhooks

Status and incidents

How notifications are delivered

Event catalogue

Account & authentication

Billing & usage

Templates

WhatsApp Flows & forms

HubSpot integration

Channels & Meta

Exports & long-running jobs

Operational sweeps

Where to manage your preferences

Related