Skip to main content

Institution Alerts

Institution Alerts allow financial institutions to enable, disable, or tailor alert types for their specific environment. They capture institution‑level opt‑in status, supported channels, and configuration overrides, enabling institutions to control which alerts are available to their customers.

End-user benefits

  • Financial institutions can customize alert types and delivery channels to align with their brand and customer preferences.
  • Enables targeted notifications for specific account types and transaction scenarios.
  • Supports multi-channel delivery (Email, SMS, Push, Web) to meet customer communication preferences.

Integration capabilities

  • List institution alert types with filters (alertTypeName, externalSystem, status active/inactive).
  • Create and maintain financial institution scoped alert type rows aligned to institution programs.
  • Provides centralized alert management by defining available alert types, configuring dynamic message templates, supporting multi‑channel delivery (Email, SMS, Push, Web), and enabling institution‑specific channel controls and customizations.

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