---
title: "Webhook: project.budget_notification"
method: POST
path: "project_budget_notification"
tags: ["Webhook"]
---

# Webhook: project.budget_notification

`POST project_budget_notification` (webhook)

This webhook is triggered when a project or subproject's budget usage crosses a defined threshold.

**Triggering Conditions:**
- The project/subproject must have budget notification thresholds configured (e.g., 50%, 60%, 70%)
- The current budget usage percentage must exceed a threshold that wasn't previously exceeded
- The webhook only fires once per threshold level (prevents duplicate notifications)
- The company must have a Trial or Enterprise subscription

**Example Scenarios:**
- Usage increases from 45% to 55% with a 50% threshold → webhook fires for 50%
- Usage increases from 55% to 60% with only a 50% threshold → webhook does NOT fire (already exceeded)
- Usage increases from 55% to 80% with thresholds at 50% and 75% → webhook fires for 75%

The `type` field in the payload indicates whether it's a `projectBudget` or `subprojectBudget` notification.
The `threshold` field contains the percentage value that was exceeded.

## Payload

- WebhookEventProjectBudgetNotification — Complete webhook body for event "project.budget_notification"
  - `subscription_id` integer, required — The ID of the webhook subscription
  - `company_id` integer, required — The ID of the company
  - `occurred_at` string, date-time, required — The timestamp when the event occurred (ISO 8601 format)
  - `payload` object, required — The event-specific payload data
    - `id` integer, required — The ID of the project
    - `type` string, required — The type of budget notification
    - `threshold` integer, required — The budget threshold percentage that was exceeded
  - `event_name` 'project.budget_notification', required — The name of the webhook event
  - `token` string, required — The webhook verification token

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.dev/clockodo/apis/clockodo-api-documentation.md) · [All operations](https://skmtc.dev/clockodo/apis/clockodo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockodo/clockodo-api-documentation/revisions/38e281d50d6d/schema)