Skip to main content

System Alerts

System Alerts define the core alert events available in the platform, including definitions that may align with external systems or third-party vendors (for example, partner platforms, notification providers, or core integrations). They describe what triggers an alert, its category and event domain, applicable account types, and supported delivery channels.

End-user benefits

  • Defines what events customers can be notified about, delivering a standardized and predictable alert experience.
  • Alerts are tied to specific account and transaction events, helping customers stay informed about meaningful activity.
  • Supports notifications across common channels to meet customer communication preferences.

Integration capabilities

  • Define available alert types and their metadata.
  • Associate notification channels (Email, SMS, Push, Web) with types where the model allows.
  • Filter list operations by alert category, alert type name, or external system.

Supported channels

ChannelDescription
EMAILEmail notifications
SMSText messages
PUSHMobile push
WEBWeb notifications

Scopes

ScopeDescription
alertMgmt:readRead alert types and associated templates
alertMgmt:writeWrite alert types and associated templates

Required headers

HeaderDescription
AuthorizationBearer OAuth 2.0 access token
transactionIdUnique request identifier

Error codes

System (PRMSYS_*)

CodeMessageHTTP Status Code
PRMSYS_10001Cross talk / concurrency error occurred400
PRMSYS_10002Malformed input data400
PRMSYS_10003Unknown application error occurred400
PRMSYS_10004Error occurred while validating JWT token400
PRMSYS_10005Resource of name already exists204
PRMSYS_10006Requested resource of identifier doesn't exist400
PRMSYS_10007Resource of identifier already exists400
PRMSYS_10008Requested resource of name doesn't exist400
PRMSYS_10015Required attribute missing400
PRMSYS_10016Non Printable ASCII character detected400

Validation (PRMVAL_*)

CodeMessageHTTP Status Code
PRMVAL_10001Path parameter doesn't match request body value400
PRMVAL_10002Invalid value for field400
PRMVAL_10003Invalid institution400
PRMVAL_10005Invalid channel type400
PRMVAL_10006Invalid alert type400
PRMVAL_10007Field is required400
PRMVAL_10008Field is invalid400

Endpoints