Skip to content
Stand with Ukraine flag

Reports in Notifications

A report can be attached to any notification template and delivered automatically when a system event occurs — such as when an alarm is created or cleared.

This is useful for combining platform notifications with analytical context: instead of receiving a simple notification (for example, an alarm), recipients receive an email with a PDF attachment summarizing the event and related data.

Prerequisites: Familiarity with reporting concepts and notifications.


When a notification rule fires, ThingsBoard:

  1. Generates the specified report using the configured user account’s permissions.
  2. Attaches the resulting PDF (or CSV) to the outgoing notification.
  3. Delivers the notification via the channels configured in the notification template.

The report is generated fresh each time the notification fires — it reflects data at the moment the event occurred.


Attach an Alarm Report to a Notification — create a PDF alarm report template and attach it to the New alarm notification template so recipients receive the report by email when an alarm fires.