> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create alert
> Create a new alert by flagging an entity.
export const CtaCallout = props => {
const {title, buttonLabel, href, trackingEvent, buttonTarget, rel = "noopener noreferrer", children} = props;
const handleCtaClick = () => {
if (typeof window === "undefined" || !trackingEvent) {
return;
}
try {
window.dispatchEvent(new CustomEvent("blnk:docs-cta", {
detail: {
name: trackingEvent,
href
}
}));
} catch {}
try {
window.posthog?.capture?.(trackingEvent, {
href
});
} catch {}
const gaPayload = {
cta_href: href
};
try {
window.gtag?.("event", trackingEvent, gaPayload);
} catch {}
try {
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: trackingEvent,
...gaPayload
});
} catch {}
};
const isExternal = typeof href === "string" && (/^https?:\/\//i).test(href);
const target = buttonTarget ?? (isExternal ? "_blank" : undefined);
const linkRel = isExternal ? rel : undefined;
return ;
};
Create a new alert programmatically. This lets you trigger, manage, and integrate alerts directly into your application logic.
***
### Request structure
```bash cURL theme={"system"}
curl -X POST 'https://api.cloud.blnkfinance.com/alerts/flag/bal_1234567890abcdef' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"title": "An identity has been flagged in a sanction list.",
"description": "this is a test"
}'
```
Unique identifier of the entity to flag. Must be a valid balance, transaction, or identity ID.
Optional. A brief title for the alert.
Required. A detailed description of the alert.
***
### Response structure
```json Success theme={"system"}
{
"anomaly_id": "ano_8a380fd1-0289-46d1-bc76-aa17a510a64e",
"title": "An identity has been flagged in a sanction list.",
"description": "this is a test",
"type": "Balance",
"assigned_to": "jerrys enebeli",
"escalated_to": [
"user_01K4EX0BRXHNNGCRVT2TPNK07W"
],
"status": "FLAGGED",
"created_at": "2026-01-15T09:22:37.55763+01:00",
"updated_at": "2026-01-15T09:26:03.094425+01:00",
"affected_balances": [
"bln_20f02af6-3728-4d37-9b5a-c7ed080f09df"
],
"affected_identities": [],
"affected_transactions": []
}
```
Unique identifier for the alert.
The title of the alert, if provided.
The description of the alert.
The type or category of the alert (e.g., "Balance", "Transaction", "Identity").
The name or identifier of the user assigned to handle the alert.
Array of user identifiers to whom the alert has been escalated.
The current status of the alert (e.g., "FLAGGED").
ISO 8601 formatted timestamp of when the alert was created.
ISO 8601 formatted timestamp of when the alert was last updated.
Array of balance IDs affected by this alert.
Array of identity IDs affected by this alert.
Array of transaction IDs affected by this alert.
***
## Need help?
We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.
To ask questions or discuss issues, please [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).
Get dedicated support for architecture reviews, integration planning, ledger workflows, and production deployment.