What events can I subscribe to?

You can subscribe to:

• LUSID events that occur in the core investment data management platform itself.
• LUSID events that occur in ecosystem applications such as Drive, Scheduler and Luminesce.
• Non-LUSID custom events that you trigger yourself by calling the CreateEvent API. You could of course attach a webhook to that event to call a LUSID API that then triggers a LUSID event, and so on.

To see the list of events you can subscribe to, obtain an API access token and call the EventTypes API for your LUSID domain, for example:

curl -X GET "https://<your-domain>.lusid.com/notifications/api/eventtypes"
  -H "Authorization: Bearer <your-API-access-token>"

The response contains a list of events and their properties. The following snippet shows the detail of the response for the LUSID TransactionPortfolioCreated event:

{
  "values": [
    {
      "id": "TransactionPortfolioCreated",
      "description": "An event of this type is fired whenever a new transaction portfolio is created in LUSID",
      "eventName": "Transaction Portfolio Created",
      "application": "Lusid",
      "jsonSchema": {
        "type": "object",
        "properties": {
          "PortfolioDisplayName": {
            "type": "string"
          },
          "PortfolioScope": {
            "type": "string"
          },
          "PortfolioCode": {
            "type": "string"
          },
          "PortfolioCreated": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "PortfolioDisplayName",
          "PortfolioScope",
          "PortfolioCode",
          "PortfolioCreated"
        ]
      }
    },
    ...
  ],
}

Note the following:

• You use the id of an event (in this case, TransactionPortfolioCreated) to subscribe to that event in the eventType field of a subscription:

  "matchingPattern": {
     "eventType": "TransactionPortfolioCreated",
     "filter": "PortfolioScope eq 'Finbourne-Examples'"
     }
  

• You can use properties of an event (in this case, PortfolioDisplayName, PortfolioScope, PortfolioCode and PortfolioCreated) in condition filters (to subscribe to events conditionally) and mustache templates (to enrich notification messages).