Notifications

Field reference for the Agent Gateway Notifications inbox: reading system notifications, marking them as read, and deleting them.

The Notifications page shows system-generated messages from the gateway. The gateway creates notifications automatically for events such as incoming connection requests and user registrations pending approval. Approving a new user can be done directly from the inbox without navigating to the Users page.

Access the Notifications page from the dashboard sidebar under Notifications.

Agent Gateway notifications

Notification fields

FieldDescription
TitleShort summary of the notification event.
MessageFull notification body. May include event-specific variables such as a surface name or identity DID.
StatusCurrent read state. Displayed as NEW, READ, or DELETED.
CreatedWhen the notification was generated.

Notifications are categorised as general gateway events, gateway connection requests, or system events such as user approvals. The category is not displayed in the UI but determines which action buttons appear when you open a notification.

Actions

ActionDescription
Select a rowOpens the full notification in a modal.
Mark as ReadAppears in the modal footer when the notification is NEW. Marks it READ without deleting it.
Approve / RejectAppears in the modal when a new user is pending approval and the notification status is still NEW. Approve sets the user status to approved and marks the notification READ. Reject shows a confirmation dialog, permanently deletes the user record, and marks the notification READ. Only visible to users with the users.approve permission.
DeleteRemoves the notification from the list. Available both in the table row and in the modal footer.

Notifications are not paginated. The list shows all notifications that have not been deleted, within the gateway’s retention window.

Notifications vs integrations

Notifications in the inbox are gateway-internal messages. They are distinct from integration deliveries, which send event payloads to external systems such as email, Slack, or webhooks.

Integrations deliver to external targets. Notifications appear in the dashboard inbox. A single event can produce both, for example, a budget alert can trigger an email via an integration and also create a notification in the inbox.

To configure which events trigger external deliveries, see Set up event notifications.