Create Room

This endpoint creates a new room within a specific Airbnb listing, including its room type and bed configuration.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/room/create 

---

Header

-app-id: App Id
Authorization: Basic Authorization
Content-Type: application/json

Header	Type	Required	Description
app-id	string	Yes	Your application ID. Required for authentication.
Authorization	string	Yes	Your API key. for authorization. Required for authentication.
Content-Type	string	Yes	Must be set to application/json.

---

Attributes

---

hotelid alphanumeric (Required)

Specifies the required node hotelid containing the IT provider's hotel ID for which the provider wishes to add mapping information.

---

channelhotelid alphanumeric (Required)

Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).

---

listingid numeric (Required)

Listing ID of the property allocated by Airbnb.

---

room_type enum (Optional)

The type of the room. Obtain the required room_type value from the master data API.

---

beds array of objects (Optional)

Array containing bed details for the room.

---

type enum (Required)

The type of bed. Obtain the required type value from the master data API.

---

quantity numeric (Optional)

The number of beds of this type in the room.

---

Request

{
  "hotelid": "SUTEST01",
  "channelhotelid": "511039958",
  "listingid": "1541919118065328804",
  "room_type": "bedroom",
  "beds": [
    {
      "type": "king_bed",
      "quantity": 1
    }
  ]
}

---

Response

---

Success Response

{
  "Status": "Success",
  "Data": {
    "listing_room": {
      "beds": [
        {
          "type": "king_bed",
          "quantity": 1
        }
      ],
      "room_type": "bedroom",
      "listing_id": "1541919118065328804",
      "is_private": true,
      "id": "752081735"
    },
    "id": "752081735"
  },
  "Message": "Room created successfully"
}

---

Success Response - Body Elements

Status string

Indicates the result of the API call. Will be "Success" if the room is created successfully.

---

Data object

Contains details of the newly created room.

---

listing_room object

Details of the created room:

---

id string

Airbnb-assigned room ID.

---

room_type string

Type of the room created.

---

listing_id string

Airbnb listing ID associated with the room.

---

is_private boolean

Indicates whether the room is private.

---

beds array of objects

Bed configuration for the room:

---

type string

Type of bed.

---

quantity numeric

Number of beds of this type.

---

id string

The room ID assigned by Airbnb (same as listing_room.id).

---

Message string

Describes the result of the operation, confirming successful room creation.

---

Error Response

Error 1

{
  "Status": "Fail",
  "Errors": [
    {
      "Code": "981",
      "ShortText": "channelhotelid is not defined or invalid value"
    }
  ]
}

Error 2

---

Error Response - Body Elements

Status string

Indicates the result of the API call.

Will be always "Fail" in case of an error response.

---

Errors object

The response error, the root element.

---

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

---

ShortText string

A short description of the error.

---

Message string

The message in the response.