---
title: "Notification Service"
slug: "notification-service"
status: "update"
updated: 2025-04-16T10:31:45Z
published: 2025-04-16T10:31:45Z
canonical: "support.lusid.com/notification-service"
---

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

# Notification Service

LUSID has a Notification Service that enables you to subscribe to the system events that LUSID and its [ecosystem of applications](/v1/docs/understanding-all-the-applications-in-the-finbourne-platform) emit, and receive notifications via multiple delivery channels when those events occur. [See the list of system events](/v1/docs/what-system-events-can-i-subscribe-to).

For example, you could [subscribe](/v1/docs/understanding-the-relationship-between-events-subscriptions-and-notifications) to a system event such as:

- A portfolio is created, updated or deleted.
- A scheduled job completes, fails or does not start.
- An order is executed, and many others.

**Note:** You can trigger the `Manual` event yourself to notify people or perform actions when non-LUSID activity occurs. [See how to do this](/v1/docs/using-the-manual-event-to-notify-people-when-non-lusid-activity-occurs).

You can subscribe to a system event:

- Unconditionally. That is, you are always notified when the system event occurs.
- Conditionally. So for example you could [write a filter](/v1/docs/using-lusid-filtering-syntax-to-subscribe-to-events-conditionally) to subscribe to the ‘portfolio created’ system event only when portfolios are created in a particular scope, or with a particular name.

When a system event occurs, you can notify:

- People via [email](/v1/docs/how-do-i-notify-people-via-email-when-an-event-occurs).
- People via [SMS](/v1/docs/how-do-i-notify-people-via-sms-when-an-event-occurs).
- An AWS queue via [SQS](/v1/docs/how-do-i-send-an-amazon-simple-queue-service-sqs-notification-when-an-event-occurs).
- An application or service (including LUSID itself) via a [webhook](/v1/docs/how-do-i-create-a-webhook-to-call-a-lusid-api-when-an-event-occurs). So for example you could subscribe to the ‘portfolio created’ system event and call the LUSID `UpsertTransactions` API to automatically seed new portfolios with cash.

Providing you have appropriate permissions, you can interact with the Notification Service using the [LUSID web app](https://www.lusid.com/app/home) via the **Notifications Management > Subscriptions** menu:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(736).png)

Alternatively, you can interact with the Notification Service programmatically:

- Using the [Notification REST API](https://jamleed.lusid.com/docs/api/notification/intro)
- Using the [Notification SDK](/v1/docs/understanding-all-the-applications-in-the-finbourne-platform) in various languages
- If you have a Luminesce license, using dedicated [read and write providers](/v1/docs/readwrite-to-notification-service-notification).

**Explanation**: *See the big picture*

- [Understanding the relationship between system events, subscriptions and notifications](/v1/docs/understanding-the-relationship-between-events-subscriptions-and-notifications)

**Tutorials**: *Get started by doing something tangible*

- [Using a webhook to automatically seed new portfolios with cash](/v1/docs/using-a-webhook-to-automatically-seed-new-portfolios-with-cash)
- [Using the Manual event to notify people when non-LUSID activity occurs](/v1/docs/using-the-manual-event-to-notify-people-when-non-lusid-activity-occurs)
- Setting up access control for different Notification Service users

**Reference**: *Understand concepts and implications*

- [What system events can I subscribe to?](/v1/docs/what-system-events-can-i-subscribe-to)
- [Using LUSID filtering syntax to subscribe to system events conditionally](/v1/docs/using-lusid-filtering-syntax-to-subscribe-to-events-conditionally)
- [Using mustache templates to enrich notification messages](/v1/docs/using-mustache-templates-to-enrich-notifications)
- [Performance, terms of service and delivery failures](/v1/docs/performance-terms-of-service-and-delivery-failures)
- [Migrating to version 2 of the Notification Service](/v1/docs/migrating-to-version-2-of-the-notification-service)

**How-to guides**: *Get something done*

- [How do I subscribe to a system event?](/v1/docs/how-do-i-subscribe-to-an-event)
- [How do I notify people via email when a system event occurs?](/v1/docs/how-do-i-notify-people-via-email-when-an-event-occurs)
- [How do I notify people via SMS when a system event occurs?](/v1/docs/how-do-i-notify-people-via-sms-when-an-event-occurs)
- [How do I create an AWS SQS notification when a system event occurs?](/v1/docs/how-do-i-send-an-amazon-simple-queue-service-sqs-notification-when-an-event-occurs)
- [How do I create a webhook to call a LUSID API when a system event occurs?](/v1/docs/how-do-i-create-a-webhook-to-call-a-lusid-api-when-an-event-occurs)
- [How do I create a webhook to call a third party (non-LUSID) API when a system event occurs?](/v1/docs/how-do-i-create-a-webhook-to-call-a-third-party-api-when-an-event-occurs)
- [How do I remove a notification from a subscription, or unsubscribe completely?](/v1/docs/how-do-i-remove-a-notification-from-a-subscription-or-unsubscribe-completely)