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

# UpdateProperty

`POST /UpdateProperty`

## Request

- Base URL: `https://api.your-ota.com/cloudbeds`
- URL: `https://api.your-ota.com/cloudbeds/UpdateProperty`
- Auth: API key in query parameter `shared_secret`

Update general data of property after it has been changed on the Cloudbeds channel manager. This call needs to be activated explicitly from our side before you can use it. Please talk to your Cloudbeds contact before implementing this call! We cannot guarantee that all of the following request fields will always be filled in, as many are optional within Cloudbeds.

## 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
  - `verb` 'UpdateProperty', required
  - `Property` object, required
    - `name` string: Property name
    - `country` string: 2-letter ISO 3166-1 alpha-2 country code. This is the country the property is located in.
    - `currency` string: 3-letter ISO 4217 currency code. This is the default currency of the property.
    - `timezone` string: Timezone the property is located in. Check (this document)[https://apidocs.myallocator.com/timezone-list.html] for valid values.
    - `email_default` string, email: The default property email address. Defaults to default user email.
    - `email_channel_booking` string, email: The email address used when forwarding channel booking emails. Defaults to default user email.
    - `email_contact` string, email: The email address of the contact person responsible for the property creation.
    - `default_min_los` integer: Default minimum length of stay setting for this property. See the description for `min_los` in the `ARIUpdate` call for more details on this restriction.
    - `default_max_los` integer: Default maximum length of stay setting for this property. See the description for `max_los` in the `ARIUpdate` call for more details on this restriction. `0` means there is no restriction.
    - `breakfast` '' | 'IN' | 'EX': Default breakfast setting for the property. Empty string means no breakfast is available, `IN` means breakfast is included in the day rates and `EX` means breakfast is excluded from day rates. Note that this setting is likely not very useful and too broad.
    - `weekend` string[]: List of weekdays that the property considers to be their weekend. Note that this setting is likely not very useful.
    - `firstname` string: First name of property owner/manager.
    - `lastname` string: First name of property owner/manager.
    - `address` object: Address of the property.
      - `address_line_1` string, nullable: First address line of the property (usually the street name and house number)
      - `address_line_2` string, nullable: Second address line of the property (if applicable)
      - `city` string, nullable: City or locality the property is located in
      - `zip` string, nullable: Post Code (ZIP) of the property
      - `state` string, nullable: State of the property (if applicable)
      - `country` string, required: 2-letter ISO 3166-1 alpha-2 country code. This is the country the property is located in. Same as `country` on the top level.
      - `website` string, nullable: Homepage of the property
      - `lon` string, nullable: Geographic longitude of the property, given as decimal degrees. Positive for east, negative for west. Example: `-117.15292`
      - `lat` string, nullable: Geographic latitude of the property, given as decimal degrees. Positive for north, negative for south. Example: `32.70954`
      - `phone` string, nullable: Phone number for the property with international country code (eg. `+44 350 5697864`)
      - `fax` string, nullable: Fax number for the property with international country code (eg. `+44 350 5697864`)
    - `business_contact` object: Contact information for invoicing
      - `main_contact_name` string, nullable: Name of the main contact for the property
      - `company_name` string, nullable: Name of the company owning the property
      - `account_manager_name` string, nullable: Name of the account manager responsible for the property
      - `vat_id` string, nullable: Tax ID for the property
      - `address_line_1` string, nullable: First address line of the company or property owner (usually the street name and house number)
      - `address_line_2` string, nullable: Second address line of the company or property owner (if applicable)
      - `state` string, nullable: State of the company or property owner (if applicable)
      - `zip` string, nullable: Post Code (ZIP) of the company or property owner
      - `city` string, nullable: City or locality the company or property owner is located in
      - `country` string, required: 2-letter ISO 3166-1 alpha-2 country code. This is the country the the company or property owner is located in.

## Response `200`

UpdateProperty

- union
  - object
    - `success` true, required
  - ResponseError
    - `errors` object[], required: Array of error objects.
      - `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 langauges, so this field is generally ignored and only useful for debugging.
    - `success` false, required

---

[API](https://skmtc.dev/cloudbeds/apis/cloudbeds-ota-build-to-us-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/cloudbeds-ota-build-to-us-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/cloudbeds-ota-build-to-us-api/revisions/baef9c11c34d?raw)