Alerts
Create alert
Create a new alert by flagging an entity.
POST
Create a new alert programmatically. This lets you trigger, manage, and integrate alerts directly into your application logic.
Prefer
/alerts. /anomalies is a legacy alias with the same alerts:read and alerts:write scopes.Authorization
Blnk Cloud APIs support any one of the following authentication methods. All of them work with yourCLOUD_API_KEY or OAUTH_ACCESS_TOKEN.
- Bearer token
- X-Blnk-Key header
- X-API-Key header
Path
string
required
Unique identifier of the entity to flag. Must be a valid balance, transaction, or identity ID.
Body
string
Optional. A brief title for the alert.
string
required
Required. A detailed description of the alert.
Response
string
Unique identifier for the alert.
string
The title of the alert, if provided.
string
The description of the alert.
string
The type or category of the alert (e.g., “Balance”, “Transaction”, “Identity”).
string
The name or identifier of the user assigned to handle the alert.
array
Array of user identifiers to whom the alert has been escalated.
string
The current status of the alert (e.g., “FLAGGED”).
timestamp
ISO 8601 formatted timestamp of when the alert was created.
timestamp
ISO 8601 formatted timestamp of when the alert was last updated.
array
Array of balance IDs affected by this alert.
array
Array of identity IDs affected by this alert.
array
Array of transaction IDs affected by this alert.