> ## 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.

Create a new alert programmatically. This lets you trigger, manage, and integrate alerts directly into your application logic.

***

### Request structure

<RequestExample>
  ```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"
    }'
  ```
</RequestExample>

<ParamField path="id" type="string" required>
  Unique identifier of the entity to flag. Must be a valid balance, transaction, or identity ID.
</ParamField>

<ParamField body="title" type="string">
  Optional. A brief title for the alert.
</ParamField>

<ParamField body="description" type="string" required>
  Required. A detailed description of the alert.
</ParamField>

***

### Response structure

<ResponseExample>
  ```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": []
  }
  ```
</ResponseExample>

<ResponseField name="anomaly_id" type="string" required>
  Unique identifier for the alert.
</ResponseField>

<ResponseField name="title" type="string">
  The title of the alert, if provided.
</ResponseField>

<ResponseField name="description" type="string" required>
  The description of the alert.
</ResponseField>

<ResponseField name="type" type="string" required>
  The type or category of the alert (e.g., "Balance", "Transaction", "Identity").
</ResponseField>

<ResponseField name="assigned_to" type="string">
  The name or identifier of the user assigned to handle the alert.
</ResponseField>

<ResponseField name="escalated_to" type="array">
  Array of user identifiers to whom the alert has been escalated.
</ResponseField>

<ResponseField name="status" type="string" required>
  The current status of the alert (e.g., "FLAGGED").
</ResponseField>

<ResponseField name="created_at" type="timestamp" required>
  ISO 8601 formatted timestamp of when the alert was created.
</ResponseField>

<ResponseField name="updated_at" type="timestamp" required>
  ISO 8601 formatted timestamp of when the alert was last updated.
</ResponseField>

<ResponseField name="affected_balances" type="array" required>
  Array of balance IDs affected by this alert.
</ResponseField>

<ResponseField name="affected_identities" type="array" required>
  Array of identity IDs affected by this alert.
</ResponseField>

<ResponseField name="affected_transactions" type="array" required>
  Array of transaction IDs affected by this alert.
</ResponseField>

***

## 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).

**Need help with your product?**

Get dedicated support for architecture reviews, integration planning, ledger workflows, and production deployment.