Setup New Channel Mapping

Setup New Channel Mapping

To setup channel mapping with host token number.

a. Get Host Token Number

Endpoint

GET

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

---

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.

---

Request

Open the provided URL in a browser. It will prompt you to log in to Airbnb, and after a successful login, it will generate and display a token. Generated token from URL is used to Setup Channel Mapping.

---

Response

Open the provided URL in a browser. It will prompt you to log in to Airbnb, and after a successful login, it will generate and display a token. Generated token from URL is used to Setup Channel Mapping.

---

Success Response

{
  "Status": "Success",
  "Data": {
    "URL": "1https://www.airbnb.com/oauth2/auth?client_id=e5h4hz2b1ovoejfwzysvyjosp&redirect_uri=https://airbnb.staah.net/common-cgi/getAuthCode_airbnb.pl&scope=vr,messages_read,messages_write"
  },
  "Message": "Host token URL get successfully"
}

---

Success Response - Body Elements

Status string

Indicates the result of the API call. Will be "Success" when room details are retrieved successfully.

---

Data object

Contains the list of rooms for the specified Airbnb listing.

---

URL string

Generated URL to Setup Channel Mapping.

---

Message string

Describes the result of the operation, confirming that rooms were retrieved successfully.

---

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.

b. Channel Password Setup

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.

---

Request

hotelid alphanumeric (Required)

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

---

host_token_number alphanumeric (Required for setup new channel mapping)

Unique code generated using get host token api.

---

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.

---

Sample Request

{
  "hotelid": "SUTEST01",
  "host_token_number": "5dqvepvp89ll74jss7hpzigl4",
  "currency": "USD",
  "markdowntax": "1",
  "convertrates": false,
  "defaultmultiplier": 1,
  "defaultsurcharge": 0,
  "connection_name": "Test Airbnb Connection"
}

---

Response

---

Success Response

{
  "Status": "Success",
  "channelhotelid": "511039958",
  "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" when the channel mapping is created or updated successfully.

---

channelhotelid string

A unique identifier generated for the hotel’s connection with Airbnb. This ID is required for all subsequent channel operations (rates, availability, reservations, etc.).

---

channelmapping array

List of Airbnb listings linked to the hotel after successful mapping.

Each object in channelmapping includes:

---

listingid string

Unique Airbnb listing ID returned after mapping.

---

listing_name string

Display name of the Airbnb listing as recognized in Airbnb.

---

Error Response

Error 1

{
  "Status": "Fail",
  "Errors": [
    {
      "Code": "1158",
      "ShortText": "Channel mapping already exists for this account "
    }
  ]
}

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.