---
title: "UpdateTaxes"
method: POST
path: "/UpdateTaxes"
tags: ["Content"]
---

# UpdateTaxes

`POST /UpdateTaxes`

Synchronize taxes/fees after they have been changed on the Cloudbeds channel manager.

## Request body

- object
  - `mya_property_id` integer, required — Property ID on the Cloudbeds channel manager
  - `ota_property_id` string, required — Username, login or property ID on the OTA
  - `ota_property_password` string, required — Password for property on your OTA. In case the OTA does not use passwords this will be an empty string.
  - `ota_property_sub_id` string, required — Property ID on the OTA, if OTA supports multiple properties under one `ota_property_id`/`ota_property_password` combination. See `GetSubProperties` for more details.
  - `guid` string, required — Request reference ID, used for debugging and support requests.
  - `shared_secret` string, required — Authentication between the OTA and the channel. Identical for all requests. Not to be shared with customers.
  - `ota_cid` string, required — OTA ID as given by Cloudbeds
  - `taxes` object, required — Object that specifies Taxes/Fees to update and/or delete.
    - `update` TaxInfo[] — List of taxes/fees to update or create
      - `id` integer, required — Tax/fee ID in Cloudbeds' system
      - `is_fee` boolean — `true` if it's a fee, otherwise it's a tax.
      - `is_inclusive` boolean, required — `true` when tax/fee included in rate.
      - `is_per_night` boolean, required — `true` when tax/fee is per night, otherwise per stay.
      - `is_percent` boolean, required — `true` when amount represents percentage, otherwise absolute value.
      - `is_refundable` boolean, required — For example, refundable damage deposit fee will set this `true`.
      - `amount` number — Tax/fee amount. Either amount in currency or percent, depending on `is_percent` field. For example 20.5 can mean 20.5% or $20.5. Only one element either `amount` or `amounts` is supposed to be active, not both.
      - `amounts` object[] — Array of tax/fee amounts. Multiple amounts may apply at the same time depending on the conditions for each item. Only one element either `amount` or `amounts` is supposed to be active, not both.
        - `amount` number, required — Tax/fee amount. Either amount in currency or percent, depending on is_percent field. For example 20.5 can mean 20.5% or $20.5.
        - `conditions` object[] — Array of conditions that determine if this amount will be applied.
          - `min_start` string — Amount of parameter above which tax is applied. For example, if `condition_parameter` is "total-price" and here we have 200, this means that tax/fee is applied when total price is more or equal 200.
          - `max_end` string — Amount of parameter below which tax is applied. For example, if `condition_parameter` is "total-price" and here we have 200, this means that tax/fee is applied when total price is less or equal 200.
          - `one_of` string[] — List of values of a parameter. For example, if `condition_parameter` is "day-of-week" then ["SAT","SUN"] might be here.
          - `max_end_inclusive` boolean — Whether the `max_end` parameter is inclusive (less or equal) or not (strictly less).
          - `min_start_inclusive` boolean — Whether the `min_start` parameter is inclusive (greater or equal) or not (strictly greater).
          - `condition_parameter` 'adult-age' | 'booking-date' | 'checkin-date' | 'checkout-date' | 'child-age' | 'date-in-range' | 'day-of-week' | 'length-of-stay' | 'length-of-stay-progressive' | 'length-of-stay-retroactive' | 'night-number' | 'nightly-rate' | 'nights-booked-in-advance' | 'number-of-guests' | 'number-of-nights' | 'number-of-pets' | 'payment-type' | 'product-code-id' | 'rate-type' | 'room-id' | 'stay-dates-intersect' | 'total-price', required — Parameter that determines whether this tax/fee will be applied or not.
      - `category` 'municipal_tax' | 'occupancy_tax' | 'other_fee' | 'other_tax' | 'resort_tax' | 'sales_tax' | 'service_charge' | 'tourism_tax' | 'vat', required — Tax category.
      - `code` string — Issued by federal government tax/fee code.
      - `external_id` string — Optional custom field to store an external system ID. Not guaranteed to be unique.
      - `name` string, required — Tax/fee name.
      - `applies_per` 'adult' | 'all-adults' | 'booking' | 'booking-external-item' | 'child' | 'children' | 'guest' | 'pet' | 'pets' | 'rateplan' | 'room' | 'room-type' | 'service', required — To which entity tax/fee is applied.
      - `conditions` object[] — Array of conditions that determine if this amount will be applied.
        - `min_start` string — Amount of parameter above which tax is applied. For example, if `condition_parameter` is "total-price" and here we have 200, this means that tax/fee is applied when total price is more or equal 200.
        - `max_end` string — Amount of parameter below which tax is applied. For example, if `condition_parameter` is "total-price" and here we have 200, this means that tax/fee is applied when total price is less or equal 200.
        - `one_of` string[] — List of values of a parameter. For example, if `condition_parameter` is "day-of-week" then ["SAT","SUN"] might be here.
        - `max_end_inclusive` boolean — Whether the `max_end` parameter is inclusive (less or equal) or not (strictly less).
        - `min_start_inclusive` boolean — Whether the `min_start` parameter is inclusive (greater or equal) or not (strictly greater).
        - `condition_parameter` 'adult-age' | 'booking-date' | 'checkin-date' | 'checkout-date' | 'child-age' | 'date-in-range' | 'day-of-week' | 'length-of-stay' | 'length-of-stay-progressive' | 'length-of-stay-retroactive' | 'night-number' | 'nightly-rate' | 'nights-booked-in-advance' | 'number-of-guests' | 'number-of-nights' | 'number-of-pets' | 'payment-type' | 'product-code-id' | 'rate-type' | 'room-id' | 'stay-dates-intersect' | 'total-price', required — Parameter that determines whether this tax/fee will be applied or not.
      - `tax_basis_includes_fees` object[]
        - `fee_id` integer, required — ID of a fee
      - `calculation_basis` 'fees' | 'fees-per-night' | 'rate' | 'rate-and-fees' | 'rate-and-fees-per-night' | 'rate-per-night' — To what value percentage will be applied in order to calculate tax amount in currency. Only applicable if `is_percent` is `true`.
    - `delete` object[] — List of taxes/fees to delete
      - `id` integer, required — Tax/fee ID on the Cloudbeds channel manager
  - `verb` 'UpdateTaxes', required

## Response `200`

UpdateTaxes

- ResponseSimple
  - `errors` object[] — Array of error objects. Required when `success` is `false`.
    - `id` integer, required — Error code. Check the "Error Codes" section of the specification for valid codes.
    - `msg` string — Optional error string to give more details about the error. Myallocator localises errors into different languages, so this field is generally ignored and only useful for debugging.
  - `success` true | false, required

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)