Trigger for budgets that sends messages to WebSocket connections
Written by
Updated at July 8, 2026
A trigger for budgets sends messages to WebSocket connections when threshold values are exceeded.
A trigger for budgets requires a service account to send messages to WebSocket connections.
For more information about creating a trigger for budgets, see Creating a trigger for budgets that sends messages to WebSocket connections.
Roles required for the proper operation of a trigger for budgets
- To create a trigger, you need a permission for the service account under which the trigger runs the operation. This permission comes with the iam.serviceAccounts.user and editor roles or higher.
- For the trigger to fire, the service account needs the
api-gateway.websocketBroadcasterrole for the folder where the API gateway resides.
Format of the message from the trigger for budgets
After the trigger fires, it will send the following message to WebSocket connections:
{
"messages":[
{
"billing_account_id":"a6q6***",
"budget_id":"a626***",
"budget_display_name":"name",
"amount":90012.00,
"currency":"RUB",
"period":"2021",
"budgeted_amount":100000.00,
"threshold_amount":90000.00,
"threshold_type":"amount"
}
]
}
Where:
billing_account_id: Billing account ID.budget_id: Budget ID.budget_display_name: Budget name.amount: Cost of resources or personal account balance when notifications were sent.currency: Payment currency.period: Budget calculation period.budgeted_amount: Budget amount.threshold_amount: Consumption threshold that triggered notifications.threshold_type: Threshold type:amount: Currency.percent: Percentage.