---
title: "Update property accounting settings"
method: PATCH
path: "/accounting/v1.0/settings"
tags: ["Settings"]
---

# Update property accounting settings

`PATCH /accounting/v1.0/settings`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/accounting/v1.0/settings`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Implicit: `https://hotels.cloudbeds.com/api/v1.2/oauth`
    - Scopes: `write:payment`

Update one or more accounting settings for a property. You only need to include the fields you want to change; unspecified fields remain unchanged. If no settings exist for the property, they are created automatically.

## Headers

- `X-Property-ID` integer, required

## Request body

- SettingPatchRequest
  - `settings` SettingValues
    - `depositConsumption` 'MANUAL' | 'CHECK_IN' | 'CHECK_OUT': Controls when deposit transactions are automatically transferred to the guest ledger. MANUAL means deposits are only transferred when explicitly requested. CHECK_IN means deposits are automatically transferred when the guest checks in. CHECK_OUT means deposits are automatically transferred when the guest checks out.

## Response `200`

OK

- SettingResponse
  - `settings` SettingValues
    - `depositConsumption` 'MANUAL' | 'CHECK_IN' | 'CHECK_OUT': Controls when deposit transactions are automatically transferred to the guest ledger. MANUAL means deposits are only transferred when explicitly requested. CHECK_IN means deposits are automatically transferred when the guest checks in. CHECK_OUT means deposits are automatically transferred when the guest checks out.

## Other responses

- `400`: Bad Request
- `404`: Not found

---

[API](https://skmtc.dev/cloudbeds/apis/accounting-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/accounting-api/revisions/0b58c698deef?raw)