# Notifications

> A notification rule tells Invunion what to report, to whom, and when. Pick events such as invoice settled or match suggested, send them instantly or as a daily, weekly, or monthly summary, narrow them with filters, and deliver them by email, Slack, or Teams. You can customize the wording, send a test, and read the history.

Source: https://www.invunion.com/knowledge-base/notifications/
Last updated: 2026-10-15

**Settings > Administration > Notifications.** Notification rules choose what Invunion tells you about, who receives it, and when. You can open it with the **Settings** permission. With View only, the page is read-only.

## How the rules work

Each notification is a **rule**. A rule does three things:

1. **What**: the events it reports, such as invoice settled or match suggested.
2. **When**: instantly, or as a daily, weekly or monthly summary.
3. **Who**: Entity members, other email addresses, and Slack or Microsoft Teams channels.

An Entity can have several rules, for example a daily summary for the finance team and an instant alert in a Slack channel for overdue invoices. If you have none yet, the page offers three starting points: **Daily summary**, **Invoice paid** and **Overdue invoices**.

<img src="/images/knowledge-base/notifications-list.png" alt="The Notifications page with one rule, Invoice paid, sent instantly, with an Entity member and an outside email address that is not yet confirmed" style="width: 90%; margin-left: auto; margin-right: auto; display: block;" />

Each rule is one card. It shows the name, when it is sent, the events and the recipients. The switch turns the rule on or off. The icons on the right send a test, open the history, edit and delete. An outside address that has not confirmed yet shows **unconfirmed, resend**.

## Add a notification

Select **Add notification**. The rule form has these fields.

| Field | What it does |
| --- | --- |
| **Name** | A label for you, for example "Invoice paid". |
| **Notify me about** | One or more events. The list is below. If you tick Invoice overdue, the field **Days after the due date** appears. |
| **When** | Instantly, or a daily, weekly or monthly summary. |
| **Filters (optional)** | Narrow the rule, for example with a minimum amount. |
| **Recipients** | Who receives the message. |
| **Message language** | The language of the message. |
| **Customize the message (optional)** | Your own title, intro and wording. |

## Events

| Event | Sent when |
| --- | --- |
| Match suggested | A match waits in the Match inbox. |
| Match confirmed | A match is confirmed. |
| Invoice payment received or reversed | A payment is matched to an invoice, or a matched payment is undone. Every installment counts. The amount shown is the change, negative for a reversal. |
| Invoice settled | An invoice has nothing left to pay, by payments, credit notes or both. |
| Invoice overdue | An open customer invoice is late by the number of days you set in the rule (1 by default, 0 means on the due date). Sent once per invoice. |
| Transaction received | A new transaction arrives. |
| Bank sync failed | A bank synchronization fails. |
| Bank disconnected | A bank connection is lost. |

Credit notes are not notified. Rules created with the former *Invoice paid* event now use *Invoice settled*, and those with *Invoice partially paid* now use *Invoice payment received or reversed*.

## When

- **Instantly.** Messages are grouped. A rule sends at most one message per minute, and an Entity at most 60 per hour.
- **As a summary.** Every day, every week, or every month, at the hour and in the time zone you choose.

Events that arrive in large numbers, such as *Transaction received* and *Match suggested*, default to a summary because an import can create hundreds.

## Filters

All filters are optional.

- Minimum amount.
- Direction: incoming and outgoing, incoming only, or outgoing only.
- Only transactions in the matching scope.
- Confidence of the match: high, medium, or low.
- Who made the match: rules, AI, or a person.

## Recipients

| Channel | Notes |
| --- | --- |
| Entity members | Tick them in the list. |
| Other email address | Type the address and select **Add**. It receives a confirmation link first and gets nothing until it confirms. Every email carries a one-click unsubscribe link that stops that recipient only. |
| Slack | Select **Slack** and paste an incoming webhook URL. In Slack: Apps > Incoming Webhooks > Add to a channel. |
| Microsoft Teams | Select **Microsoft Teams** and paste a workflow URL. In Teams: channel menu > Workflows > "Post to a channel when a webhook request is received". |

Saved Slack and Teams URLs are not shown again. Paste a new one to replace it. If Slack or Teams answers that the URL is gone or forbidden, Invunion disables that recipient.

## Example: Invoice paid

This rule tells people as soon as an invoice is fully settled.

<img src="/images/knowledge-base/notification-rule-edit.png" alt="The Edit notification rule form: name Invoice paid, event Invoice settled ticked, When Instantly, an optional minimum amount, one Entity member and one outside email address as recipients, and Slack and Microsoft Teams buttons" style="width: 60%; margin-left: auto; margin-right: auto; display: block;" />

| Setting | Value | Why |
| --- | --- | --- |
| **Name** | Invoice paid | Only a label. |
| **Notify me about** | Invoice settled | The rule reports invoices that are fully settled, not each installment. Add *Invoice payment received or reversed* to hear about every payment. |
| **When** | Instantly | Each payment is reported as it happens. Messages are grouped, so a busy minute sends one message. |
| **Filters** | Minimum amount left empty | Every amount is reported. A value would skip smaller invoices. |
| **Recipients** | An Entity member and an outside address | The outside address receives a confirmation link first and gets nothing until it confirms. |

Below the recipients, **Slack** and **Microsoft Teams** add a channel to the same rule. To set up Slack, follow [Connect Slack to notifications](https://www.invunion.com/knowledge-base/connect-slack/).

### The message

<img src="/images/knowledge-base/notification-message-customize.png" alt="The message part of the rule form: message language English, the Customize the message section with Title, Intro and One line per event left on the default text, and a preview built from example data" style="width: 60%; margin-left: auto; margin-right: auto; display: block;" />

By default Invunion writes the title, the intro and one line per event. In **Customize the message** you can replace any of them. Type `{` in a field, or use the `{}` button, to insert a variable such as the invoice number. **All variables** lists them. Empty fields keep the default text, and the same wording is used for email, Slack and Teams. Unknown variables are rejected when you save.

The **Preview** shows the result from example data, so you can check the wording before you save:

- **Subject:** `[Invunion] 1 invoice settled`. The title is also the email subject.
- **Intro:** "Here is what just happened in Invunion."
- **Event line:** "1 invoice settled (€160.00)", then one row for the invoice with the customer and the amount.

## Test and history

- **Send test** sends a message to every recipient of the rule.
- **History** lists the last 50 messages with time, recipient, number of events, and status: pending, sent, failed, or skipped. A badge on the rule counts failures in the last 24 hours.
- Failed sends are retried 5 times, after 1, 4, 16, and 64 minutes.

## Limits to keep in mind

- A rule never replays old events. A new or re-enabled rule starts from the newest event.
- To feed your own systems instead of people, use [Webhooks](https://www.invunion.com/knowledge-base/webhooks/).
