> ## Documentation Index
> Fetch the complete documentation index at: https://docs.up2data.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update account settings

> Default notification settings and the monitoring budget cap.

**Cost: Free**

Account-level settings that Signals inherit. Partial update — send only what you're changing.

<ParamField body="monitoring" type="object">
  <Expandable title="Monitoring fields">
    <ParamField body="default_webhook_url" type="string">
      Used by any Signal created without a `notify` block — the standard pattern for [bulk-created](/api-reference/signals/bulk-create) fleets.
    </ParamField>

    <ParamField body="default_webhook_secret" type="string">
      Signs deliveries to the default webhook.
    </ParamField>

    <ParamField body="monthly_check_budget" type="integer">
      Hard cap (in credits) on total Signal check spend per calendar month. When reached, Signals pause with `paused_reason: "budget_exceeded"` and a `signal.paused` event — enrichment usage is unaffected. Set `null` for no cap.
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.up2data.ai/v1/account \
    -H "X-API-Key: $UP2DATA_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "monitoring": {
        "default_webhook_url": "https://app.example.com/hooks/up2data",
        "default_webhook_secret": "whsec_default_9dk1m",
        "monthly_check_budget": 50000
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "account_id": "acc_19dm3nx8",
      "monitoring": {
        "default_webhook_url": "https://app.example.com/hooks/up2data",
        "monthly_check_budget": 50000,
        "checks_spent_this_month": 12480
      }
    },
    "meta": { "creditsUsed": 0, "billed": false, "reason": "account_updated", "requestId": "req_au02mn1x" }
  }
  ```
</ResponseExample>

<Tip>
  Size the budget from [`GET /v1/account`](/api-reference/account/get): `signals.estimated_monthly_credits` is your standing burn — set the cap comfortably above it so growth trips the alarm, not normal operation.
</Tip>
