---
title: Push Property
slug: push-property
createdAt: 2025-10-13T06:05:51.357Z
---

:::ApiMethodV2
```json
{
  "name": "Push Property ",
  "method": "POST",
  "url": "https://wsb.bakuun.com/v2/push-property/test/MPBXX/XXXX",
  "description": "Sends property static data and mapping information from the Buyer to Bakuun.\n\nThis action is typically used when:\n\nA new property is onboarded is updated in Bakuun or when the mapping status change\n\n",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "AoEpe2dZR_dbSk5ugr5Rn",
        "language": "json",
        "code": "{\n    \"username\": \"testusername\",\n    \"password\": \"testpassword\",\n    \"propertyId\": \"HTLXX.1\",\n    \"partnerId\": \"MPBKXX\",\n    \"action\": \"pushPropertyInfo\",\n    \"mappingStatus\": \"Active\",\n    \"propertyData\": {\n        \"propertyName\": \"Hotel Form\",\n        \"country\": \"Test\",\n        \"region\": \"Test\",\n        \"city\": \"Test\",\n        \"area\": \"Test\",\n        \"zipCode\": \"123456\",\n        \"address\": \"Test\",\n        \"latitude\": \"1.35601825\",\n        \"longitude\": \"103.9884945\",\n        \"prefixPhone\": \"+1\",\n        \"phoneNum\": \"123456789\",\n        \"currency\": \"XXX\",\n        \"roomTypes\": [\n            {\n                \"roomTypeId\": \"RXX.1.9\",\n                \"roomName\": \"One-bedroom Villa\",\n                \"type\": \"DailyRoom\",\n                \"rateTypes\": [\n                    {\n                        \"ratePlanId\": \"RXX.1.9.2\",\n                        \"ratePlanName\": \"Superior One Room Breakfast rate\",\n                        \"cancelType\": \"1\",\n                        \"authPerson\": \"7\",\n                        \"defaultMeal\": \"RO\",\n                        \"rateCategory\": \"\",\n                        \"restrictedCountry\": \"\"\n                    }\n                ]\n            },\n            {\n                \"roomTypeId\": \"RXX.1.10\",\n                \"roomName\": \"Single Room -new Year's Special Event\",\n                \"type\": \"DailyRoom\",\n                \"rateTypes\": [\n                    {\n                        \"ratePlanId\": \"RXX.1.10.1\",\n                        \"ratePlanName\": \"Single Room Breakfast rate\",\n                        \"cancelType\": \"1\",\n                        \"authPerson\": \"6\",\n                        \"defaultMeal\": \"BB\",\n                        \"rateCategory\": \"\",\n                        \"restrictedCountry\": \"\"\n                    }\n                ]\n            },\n            {\n                \"roomTypeId\": \"RXX.1.1\",\n                \"roomName\": \"Family Room With Lake View\",\n                \"type\": \"DailyRoom\",\n                \"rateTypes\": [\n                    {\n                        \"ratePlanId\": \"RXX.1.1.2\",\n                        \"ratePlanName\": \"Family Room Breakfast rate\",\n                        \"cancelType\": \"1\",\n                        \"authPerson\": \"10\",\n                        \"defaultMeal\": \"HB\",\n                        \"rateCategory\": \"\",\n                        \"restrictedCountry\": \"\"\n                    }\n                ]\n            },\n            {\n                \"roomTypeId\": \"RXX.1.2\",\n                \"roomName\": \"Deluxe Queen Room With Two Queen Beds\",\n                \"type\": \"DailyRoom\",\n                \"rateTypes\": [\n                    {\n                        \"ratePlanId\": \"RXX.1.2.1\",\n                        \"ratePlanName\": \"Hotel Bar\",\n                        \"cancelType\": \"0\",\n                        \"authPerson\": \"14\",\n                        \"defaultMeal\": \"BB\",\n                        \"rateCategory\": \"\",\n                        \"restrictedCountry\": \"\"\n                    },\n                    {\n                        \"ratePlanId\": \"RXX.1.2.2\",\n                        \"ratePlanName\": \"Bar Rate\",\n                        \"cancelType\": \"1\",\n                        \"authPerson\": \"5\",\n                        \"defaultMeal\": \"RO\",\n                        \"rateCategory\": \"\",\n                        \"restrictedCountry\": \"\"\n                    },\n                    {\n                        \"ratePlanId\": \"RXX.1.2.3\",\n                        \"ratePlanName\": \"Bar Rate\",\n                        \"cancelType\": \"0\",\n                        \"authPerson\": \"12\",\n                        \"defaultMeal\": \"BB\",\n                        \"rateCategory\": \"\",\n                        \"restrictedCountry\": \"\"\n                    },\n                    {\n                        \"ratePlanId\": \"RXX.1.2.5\",\n                        \"ratePlanName\": \"Bar Rate\",\n                        \"cancelType\": \"1\",\n                        \"authPerson\": \"6\",\n                        \"defaultMeal\": \"RO\",\n                        \"rateCategory\": \"\",\n                        \"restrictedCountry\": \"\"\n                    },\n                    {\n                        \"ratePlanId\": \"RXX.1.2.6\",\n                        \"ratePlanName\": \"Bar Rate\",\n                        \"cancelType\": \"1\",\n                        \"authPerson\": \"3\",\n                        \"defaultMeal\": \"BB\",\n                        \"rateCategory\": \"\",\n                        \"restrictedCountry\": \"\"\n                    }\n                ]\n            }\n        ]\n    }\n}",
        "customLabel": ""
      },
      {
        "id": "887CwvV_bY_CdLj-s64eH",
        "language": "curl",
        "code": "curl --location 'https://wsb.bakuun.com/v2/push-property/test/MPBXX/281627' \\\n--header 'Accept: application/json' \\\n--header 'Content-Type: application/json' \\\n--data '{\n  \"username\": \"String\",\n  \"password\": \"String\",\n  \"propertyId\": \"String\",\n  \"partnerId\": \"String\",\n  \"action\": \"String\",\n  \"mappingStatus\": \"String\",\n  \"propertyData\": {\n    \"propertyName\": \"\",\n    \"country\": \"\",\n    \"region\": \"\",\n    \"city\": \"\",\n    \"area\": \"\",\n    \"zipCode\": \"\",\n    \"address\": \"\",\n    \"latitude\": \"\",\n    \"longitude\": \"\",\n    \"prefixPhone\": \"\",\n    \"phoneNum\": \"\",\n    \"currency\": \"\",\n    \"roomTypes\": {\n      \"roomTypeId\": \"\",\n      \"roomName\": \"\",\n      \"type\": \"\",\n      \"rateTypes\": {\n        \"ratePlanId\": \"\",\n        \"ratePlanName\": \"\",\n        \"cancelType\": \"\",\n        \"authPerson\": \"\",\n        \"defaultMeal\": \"\",\n        \"rateCategory\": \"\",\n        \"restrictedCountry\": \"\"\n      }\n    }\n  }\n}'",
        "customLabel": ""
      },
      {
        "id": "Swfb6rL2hIxSDq1RoE3M9",
        "language": "nodejs",
        "code": "var request = require('request');\nvar options = {\n   'method': 'POST',\n   'url': 'https://wsb.bakuun.com/v2/push-property/test/MPBXX/281627',\n   'headers': {\n      'Accept': 'application/json',\n      'Content-Type': 'application/json'\n   },\n   body: JSON.stringify({\n      \"username\": \"String\",\n      \"password\": \"String\",\n      \"propertyId\": \"String\",\n      \"partnerId\": \"String\",\n      \"action\": \"String\",\n      \"mappingStatus\": \"String\",\n      \"propertyData\": {\n         \"propertyName\": \"\",\n         \"country\": \"\",\n         \"region\": \"\",\n         \"city\": \"\",\n         \"area\": \"\",\n         \"zipCode\": \"\",\n         \"address\": \"\",\n         \"latitude\": \"\",\n         \"longitude\": \"\",\n         \"prefixPhone\": \"\",\n         \"phoneNum\": \"\",\n         \"currency\": \"\",\n         \"roomTypes\": {\n            \"roomTypeId\": \"\",\n            \"roomName\": \"\",\n            \"type\": \"\",\n            \"rateTypes\": {\n               \"ratePlanId\": \"\",\n               \"ratePlanName\": \"\",\n               \"cancelType\": \"\",\n               \"authPerson\": \"\",\n               \"defaultMeal\": \"\",\n               \"rateCategory\": \"\",\n               \"restrictedCountry\": \"\"\n            }\n         }\n      }\n   })\n\n};\nrequest(options, function (error, response) {\n   if (error) throw new Error(error);\n   console.log(response.body);\n});\n",
        "customLabel": ""
      },
      {
        "id": "jyhnhVykWiIqCAE9zAIly",
        "language": "javascript",
        "code": "var myHeaders = new Headers();\nmyHeaders.append(\"Accept\", \"application/json\");\nmyHeaders.append(\"Content-Type\", \"application/json\");\n\nvar raw = JSON.stringify({\n   \"username\": \"String\",\n   \"password\": \"String\",\n   \"propertyId\": \"String\",\n   \"partnerId\": \"String\",\n   \"action\": \"String\",\n   \"mappingStatus\": \"String\",\n   \"propertyData\": {\n      \"propertyName\": \"\",\n      \"country\": \"\",\n      \"region\": \"\",\n      \"city\": \"\",\n      \"area\": \"\",\n      \"zipCode\": \"\",\n      \"address\": \"\",\n      \"latitude\": \"\",\n      \"longitude\": \"\",\n      \"prefixPhone\": \"\",\n      \"phoneNum\": \"\",\n      \"currency\": \"\",\n      \"roomTypes\": {\n         \"roomTypeId\": \"\",\n         \"roomName\": \"\",\n         \"type\": \"\",\n         \"rateTypes\": {\n            \"ratePlanId\": \"\",\n            \"ratePlanName\": \"\",\n            \"cancelType\": \"\",\n            \"authPerson\": \"\",\n            \"defaultMeal\": \"\",\n            \"rateCategory\": \"\",\n            \"restrictedCountry\": \"\"\n         }\n      }\n   }\n});\n\nvar requestOptions = {\n   method: 'POST',\n   headers: myHeaders,\n   body: raw,\n   redirect: 'follow'\n};\n\nfetch(\"https://wsb.bakuun.com/v2/push-property/test/MPBXX/281627\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));",
        "customLabel": ""
      },
      {
        "id": "gwmwwtYmaroMT9kW_gpSR",
        "language": "python",
        "code": "import requests\nimport json\n\nurl = \"https://wsb.bakuun.com/v2/push-property/test/MPBXX/281627\"\n\npayload = json.dumps({\n   \"username\": \"String\",\n   \"password\": \"String\",\n   \"propertyId\": \"String\",\n   \"partnerId\": \"String\",\n   \"action\": \"String\",\n   \"mappingStatus\": \"String\",\n   \"propertyData\": {\n      \"propertyName\": \"\",\n      \"country\": \"\",\n      \"region\": \"\",\n      \"city\": \"\",\n      \"area\": \"\",\n      \"zipCode\": \"\",\n      \"address\": \"\",\n      \"latitude\": \"\",\n      \"longitude\": \"\",\n      \"prefixPhone\": \"\",\n      \"phoneNum\": \"\",\n      \"currency\": \"\",\n      \"roomTypes\": {\n         \"roomTypeId\": \"\",\n         \"roomName\": \"\",\n         \"type\": \"\",\n         \"rateTypes\": {\n            \"ratePlanId\": \"\",\n            \"ratePlanName\": \"\",\n            \"cancelType\": \"\",\n            \"authPerson\": \"\",\n            \"defaultMeal\": \"\",\n            \"rateCategory\": \"\",\n            \"restrictedCountry\": \"\"\n         }\n      }\n   }\n})\nheaders = {\n   'Accept': 'application/json',\n   'Content-Type': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n",
        "customLabel": ""
      },
      {
        "id": "u8y_-I6QbrHXhSNnOpGRE",
        "language": "ruby",
        "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://wsb.bakuun.com/v2/push-property/test/MPBXX/281627\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"Accept\"] = \"application/json\"\nrequest[\"Content-Type\"] = \"application/json\"\nrequest.body = JSON.dump({\n   \"username\": \"String\",\n   \"password\": \"String\",\n   \"propertyId\": \"String\",\n   \"partnerId\": \"String\",\n   \"action\": \"String\",\n   \"mappingStatus\": \"String\",\n   \"propertyData\": {\n      \"propertyName\": \"\",\n      \"country\": \"\",\n      \"region\": \"\",\n      \"city\": \"\",\n      \"area\": \"\",\n      \"zipCode\": \"\",\n      \"address\": \"\",\n      \"latitude\": \"\",\n      \"longitude\": \"\",\n      \"prefixPhone\": \"\",\n      \"phoneNum\": \"\",\n      \"currency\": \"\",\n      \"roomTypes\": {\n         \"roomTypeId\": \"\",\n         \"roomName\": \"\",\n         \"type\": \"\",\n         \"rateTypes\": {\n            \"ratePlanId\": \"\",\n            \"ratePlanName\": \"\",\n            \"cancelType\": \"\",\n            \"authPerson\": \"\",\n            \"defaultMeal\": \"\",\n            \"rateCategory\": \"\",\n            \"restrictedCountry\": \"\"\n         }\n      }\n   }\n})\n\nresponse = https.request(request)\nputs response.read_body\n",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "AoEpe2dZR_dbSk5ugr5Rn"
  },
  "results": {
    "languages": [
      {
        "id": "BVUJfRIDCM7lLpYvvpE0n",
        "language": "200",
        "code": "{\n  \"success\": true\n}",
        "customLabel": ""
      },
      {
        "id": "4tRsQTZIivrTDf0gTBjxr",
        "language": "431",
        "code": "{\n  \"success\": false,\n  \"errors\": [\n    {\n      \"code\": 454,\n      \"message\": \"Endpoint bad format\"\n    }\n  ]\n}",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "BVUJfRIDCM7lLpYvvpE0n"
  },
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "name": "username",
        "kind": "required",
        "type": "string",
        "description": "System-generated, human-readable API access key (unique per account).",
        "": "System-generated, human-readable API access key (unique per account)."
      },
      {
        "name": "password",
        "kind": "required",
        "type": "string",
        "description": "System-generated, human-readable API access key (unique per account).",
        "": "System-generated, human-readable API access key (unique per account)."
      },
      {
        "name": "propertyId",
        "kind": "required",
        "type": "string",
        "description": "Property identifier on your side or mapping key (e.g. HTLXX.1).",
        "": "Property identifier on your side or mapping key (e.g. HTLXX.1)."
      },
      {
        "name": "partnerId",
        "kind": "required",
        "type": "string",
        "description": "Partner (buyer) identifier (e.g. RDKXX - MPBXXX).",
        "": "Partner (buyer) identifier (e.g. RDKXX - MPBXXX)."
      },
      {
        "name": "action",
        "kind": "required",
        "type": "string",
        "description": "Must be set to pushPropertyInfo.",
        "": "Must be set to pushPropertyInfo."
      },
      {
        "name": "mappingStatus",
        "kind": "required",
        "type": "string",
        "description": "Current mapping status for this property (e.g. Active, Suspended - Disconnected)\n",
        "": "Current mapping status for this property (e.g. Active, Suspended - Disconnected)\n"
      },
      {
        "name": "propertyData",
        "kind": "required",
        "type": "object",
        "description": "Container for all static property, room, and rate plan data.",
        "": "Container for all static property, room, and rate plan data.",
        "children": [
          {
            "name": "propertyName",
            "kind": "required",
            "type": "string",
            "description": "Name of the property as shown to users."
          },
          {
            "name": "country",
            "kind": "required",
            "type": "string",
            "description": "Country name"
          },
          {
            "name": "region",
            "kind": "required",
            "type": "string",
            "description": "Region / state / province."
          },
          {
            "name": "city",
            "kind": "required",
            "type": "string",
            "description": "City name."
          },
          {
            "name": "area",
            "kind": "required",
            "type": "string",
            "description": "Local area / neighborhood."
          },
          {
            "name": "zipCode",
            "kind": "required",
            "type": "string",
            "description": "Postal / ZIP code."
          },
          {
            "name": "address",
            "kind": "required",
            "type": "string",
            "description": "Street address."
          },
          {
            "name": "latitude",
            "kind": "required",
            "type": "string",
            "description": "Latitude of the property."
          },
          {
            "name": "longitude",
            "kind": "required",
            "type": "string",
            "description": "Longitude of the property."
          },
          {
            "name": "prefixPhone",
            "kind": "required",
            "type": "string",
            "description": "Phone country code prefix (e.g. +1)."
          },
          {
            "name": "phoneNum",
            "kind": "required",
            "type": "string",
            "description": "Phone number."
          },
          {
            "name": "currency",
            "kind": "required",
            "type": "string",
            "description": "Default selling currency code for the property."
          },
          {
            "name": "roomTypes",
            "kind": "required",
            "type": "object",
            "description": "List of room types configured for this property.",
            "children": [
              {
                "name": "roomTypeId",
                "kind": "required",
                "type": "string",
                "description": "Unique identifier for the room type"
              },
              {
                "name": "roomName",
                "kind": "required",
                "type": "string",
                "description": "Descriptive name of the room type (e.g. Deluxe Queen Room With Two Queen Beds)."
              },
              {
                "name": "type",
                "kind": "required",
                "type": "string",
                "description": "DailyRoom would be the used default category "
              },
              {
                "name": "rateTypes",
                "kind": "required",
                "type": "object",
                "description": "",
                "children": [
                  {
                    "name": "ratePlanId",
                    "kind": "required",
                    "type": "string",
                    "description": "Unique identifier for the rate plan (e.g. RXX.1.2.1)."
                  },
                  {
                    "name": "ratePlanName",
                    "kind": "required",
                    "type": "string",
                    "description": "Name of the rate plan (e.g. Advance Purchase )."
                  },
                  {
                    "name": "cancelType",
                    "kind": "required",
                    "type": "string",
                    "description": "Cancellation rule type code (mapping provided by Bakuun; e.g. 0 = non-refundable, 1 = refundable)."
                  },
                  {
                    "name": "authPerson",
                    "kind": "required",
                    "type": "string",
                    "description": "Maximum authorized occupancy (number of persons) for this rate plan."
                  },
                  {
                    "name": "defaultMeal",
                    "kind": "required",
                    "type": "string",
                    "description": "Default meal plan code (e.g. 0 = Room Only, 1 = Breakfast, 2 = Half Board, 3 = Full Board — actual mapping defined in your integration)."
                  },
                  {
                    "name": "rateCategory",
                    "kind": "required",
                    "type": "string",
                    "description": " Assigned rate category (e.g. corporate, package, promotion)"
                  },
                  {
                    "name": "restrictedCountry",
                    "kind": "required",
                    "type": "string",
                    "description": "Optional country restrictions for selling this rate. Can be empty or contain a list of countries."
                  }
                ]
              }
            ]
          }
        ],
        "schema": [
          {
            "name": "propertyName",
            "kind": "required",
            "type": "string",
            "description": "Name of the property as shown to users."
          },
          {
            "name": "country",
            "kind": "required",
            "type": "string",
            "description": "Country name"
          },
          {
            "name": "region",
            "kind": "required",
            "type": "string",
            "description": "Region / state / province."
          },
          {
            "name": "city",
            "kind": "required",
            "type": "string",
            "description": "City name."
          },
          {
            "name": "area",
            "kind": "required",
            "type": "string",
            "description": "Local area / neighborhood."
          },
          {
            "name": "zipCode",
            "kind": "required",
            "type": "string",
            "description": "Postal / ZIP code."
          },
          {
            "name": "address",
            "kind": "required",
            "type": "string",
            "description": "Street address."
          },
          {
            "name": "latitude",
            "kind": "required",
            "type": "string",
            "description": "Latitude of the property."
          },
          {
            "name": "longitude",
            "kind": "required",
            "type": "string",
            "description": "Longitude of the property."
          },
          {
            "name": "prefixPhone",
            "kind": "required",
            "type": "string",
            "description": "Phone country code prefix (e.g. +1)."
          },
          {
            "name": "phoneNum",
            "kind": "required",
            "type": "string",
            "description": "Phone number."
          },
          {
            "name": "currency",
            "kind": "required",
            "type": "string",
            "description": "Default selling currency code for the property."
          },
          {
            "name": "roomTypes",
            "kind": "required",
            "type": "object",
            "description": "List of room types configured for this property.",
            "children": [
              {
                "name": "roomTypeId",
                "kind": "required",
                "type": "string",
                "description": "Unique identifier for the room type"
              },
              {
                "name": "roomName",
                "kind": "required",
                "type": "string",
                "description": "Descriptive name of the room type (e.g. Deluxe Queen Room With Two Queen Beds)."
              },
              {
                "name": "type",
                "kind": "required",
                "type": "string",
                "description": "DailyRoom would be the used default category "
              },
              {
                "name": "rateTypes",
                "kind": "required",
                "type": "object",
                "description": "",
                "children": [
                  {
                    "name": "ratePlanId",
                    "kind": "required",
                    "type": "string",
                    "description": "Unique identifier for the rate plan (e.g. RXX.1.2.1)."
                  },
                  {
                    "name": "ratePlanName",
                    "kind": "required",
                    "type": "string",
                    "description": "Name of the rate plan (e.g. Advance Purchase )."
                  },
                  {
                    "name": "cancelType",
                    "kind": "required",
                    "type": "string",
                    "description": "Cancellation rule type code (mapping provided by Bakuun; e.g. 0 = non-refundable, 1 = refundable)."
                  },
                  {
                    "name": "authPerson",
                    "kind": "required",
                    "type": "string",
                    "description": "Maximum authorized occupancy (number of persons) for this rate plan."
                  },
                  {
                    "name": "defaultMeal",
                    "kind": "required",
                    "type": "string",
                    "description": "Default meal plan code (e.g. 0 = Room Only, 1 = Breakfast, 2 = Half Board, 3 = Full Board — actual mapping defined in your integration)."
                  },
                  {
                    "name": "rateCategory",
                    "kind": "required",
                    "type": "string",
                    "description": " Assigned rate category (e.g. corporate, package, promotion)"
                  },
                  {
                    "name": "restrictedCountry",
                    "kind": "required",
                    "type": "string",
                    "description": "Optional country restrictions for selling this rate. Can be empty or contain a list of countries."
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "response": [
    {
      "name": "success",
      "kind": "optional",
      "type": "boolean",
      "description": "true",
      "children": []
    }
  ],
  "autoGeneratedAnchorSlug": "push-property",
  "legacyHash": "Wd211LDEEnfLn83hrCLaU"
}
```
:::



