Setup Existing Channel Password with channel hotel id

This endpoint adds a new channel mapping or updates an existing one for a hotel in an external distribution channel or PMS.

If channel hotel id exists in same hotel id, it will update the data otherwise it will create new channel mapping.

---

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/channelmap/addEditChannelMapping

---

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 contains 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).

---

currency string (Required)

Specifies the default currency code used for pricing.

---

convertrates boolean (Optional)

Indicates whether the API should automatically convert prices into the configured currency.

---

defaultmultiplier number (Optional)

Defines the default multiplier value applied in rateplan mapping.

---

defaultsurcharge number (Optional)

Specifies the default surcharge value applied in rateplan mapping.

---

connection_name string (Optional)

Provides a unique name for the hotel connection to identify it easily in dashboards and reports.

---

Request

{
  "hotelid": "SUTEST01",
  "action": "setup",
  "channelhotelid": "511039958",
  "currency": "USD",
  "markdowntax": "1",
  "convertrates": false,
  "defaultmultiplier": 1,
  "defaultsurcharge": 0,
  "connection_name": "Existing Airbnb Connection"
}

---

Response

---

Success Response

{
  "Status": "Success",
  "channelmapping": [
    {
      "listingid": "1511472636542116263",
      "listing_name": "Test Listing"
    },
    {
      "listingid": "1460656632408024582",
      "listing_name": "STAAH SU listing"
    },
    {
      "listingid": "1211374819767069431",
      "listing_name": "Deluxe Double Room"
    },
    {
      "listingid": "1198901603815924758",
      "listing_name": "Deluxe Double Room Best Rate Available Rate Plan"
    }
  ]
}

---

Success Response - Body Elements

Status string

Indicates the result of the API call. Will be "Success" for a successful response.

---

channelmapping array

List of channel mappings created or updated for the hotel.

---

listingid string

Unique identifier of the listing in the channel.

---

listing_name string

Name of the listing in the channel.

---

Error Response

Error 1

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

---

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.