# Update balance settings

Updates balance settings for a given connected account. Related guide: [Making API calls for connected accounts](https://docs.stripe.com/connect/authentication.md)

## Request

```curl
curl https://api.stripe.com/v1/balance_settings \
  -u "<<YOUR_SECRET_KEY>>" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -d "payments[payouts][schedule][interval]=monthly" \
  -d "payments[payouts][schedule][monthly_payout_days][]=5" \
  -d "payments[payouts][schedule][monthly_payout_days][]=20"
```

### Response

```json
{
  "object": "balance_settings",
  "payments": {
    "debit_negative_balances": true,
    "payouts": {
      "automatic_transfer_rules_by_currency": {
        "usd": [
          {
            "type": "transfer_all",
            "payout_method": "fa_1ABC"
          }
        ]
      },
      "minimum_balance_by_currency": {
        "usd": 1500,
        "cad": 8000
      },
      "schedule": {
        "interval": "monthly",
        "monthly_payout_days": [
          5,
          20
        ]
      },
      "statement_descriptor": null,
      "status": "enabled"
    },
    "settlement_timing": {
      "delay_days_override": 3,
      "delay_days": 3
    }
  }
}
```

## Returns

Returns the updated balance settings object for the account that was authenticated in the request.

## Parameters

- [`payments`](https://docs.stripe.com/api/balance-settings/update.md?query=payments) (object, optional)
  Settings that apply to the [Payments Balance](https://docs.stripe.com/api/balance.md).