Accept Connection

This endpoint is used to approve and activate a connection request for a specific property.

---

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/connection/acceptConnection

Header

-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/json

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

---

Attributes

hotel_id string (Required)

Specifies the hotel ID for the property.

---

channel_hotel_id string (Required)

Specifies the channel-specific hotel ID for the property.

---

pricing_model string (Optional)

Defines the pricing strategy used by the property.

---

connection_types array (Optional)

List of data integration types supported by the channel connection.

connection_types[] string (Optional)

Individual connection type indicating the specific functionality integrated.

Allowable Connection types are:

• AVAILABILITY

• PHOTOS

• RESERVATIONS

• REVIEWS

• REPORTING

• CONTENT

---

Sample Request

{
  "hotel_id": "new1",
  "channel_hotel_id": "12915674",
  "pricing_model": "Standard",
  "connection_types": [
    "AVAILABILITY",
    "PHOTOS",
    "RESERVATIONS",
    "REVIEWS",
    "REPORTING",
    "CONTENT"
  ]
}

---

Response

Success Response Body Elements

Status string

Indicates the result of the API call (for example "Success", "Fail").

---

Data object

Contains detailed information related to the property, connection, legal entity, and pricing.

---

Data.legal_entity object

Information about the owning or managing legal entity of the property.

---

Data.legal_entity.id integer

Unique identifier of the legal entity in the system.

---

Data.legal_entity.company_name string

Official name of the legal entity or company managing the property.

---

Data.connection_types object

Timestamps indicating when each connection type was established.

---

Data.connection_types.REVIEWS string

Timestamp of when the reviews connection was established.

---

Data.connection_types.CONTENT string

Timestamp of when the content connection was established.

---

Data.connection_types.PHOTOS string

Timestamp of when the photos connection was established.

---

Data.connection_types.AVAILABILITY string

Timestamp of when the availability connection was established.

---

Data.connection_types.REPORTING string

Timestamp of when the reporting connection was established.

---

Data.connection_types.RESERVATIONS string

Timestamp of when the reservations connection was established.

---

Data.connected_at string

Timestamp representing when the property was first connected.

---

Data.last_connected_at string

Timestamp representing the most recent successful connection.

---

Data.property object

Detailed property information.

---

Data.property.country_code string

Country code representing the property's location.

---

Data.property.zip_code string

Postal code for the property's location.

---

Data.property.id integer

Unique identifier of the property in the system.

---

Data.property.name string

Name of the hotel or property.

---

Data.property.city string

City where the property is located.

---

Data.property.address string

Street address of the property.

---

Data.pricing object

Contains pricing-related information for the property.

---

Data.pricing.currency_code string

Currency code used for pricing.

---

Data.pricing.model string

Indicates the pricing model applied to the property.

---

Message string

Descriptive message providing status context of the API operation.

---

Ruid string

Unique request identifier used for logging, tracing, and debugging.

---

Sample Success Response

{
  "Status": "Success",
  "Data": {
    "legal_entity": {
      "id": 12345,
      "company_name": "XYZ Test Inc"
    },
    "connection_types": {
      "REVIEWS": "2023-08-03T14:06:22Z",
      "CONTENT": "2023-08-03T14:06:22Z",
      "PHOTOS": "2023-08-03T14:06:22Z",
      "AVAILABILITY": "2023-08-03T14:06:22Z",
      "REPORTING": "2023-08-03T14:06:22Z",
      "RESERVATIONS": "2023-08-03T14:06:22Z"
    },
    "connected_at": "2023-08-03T14:06:22Z",
    "last_connected_at": "2023-08-03T14:06:22Z",
    "property": {
      "country_code": "nl",
      "zip_code": "1000 VL",
      "id": 8011855,
      "name": "HillTop Hotel",
      "city": "Amsterdam",
      "address": "Nieuwe straat 157"
    },
    "pricing": {
      "currency_code": "EUR",
      "model": "Standard"
    }
  },
  "Message": "Connection Request Accepted Successfully",
  "Ruid": "f4ef89ae-9de1-4eaa-bf74-10c05459b1f5"
}

---

Error

Sample Error Response 1

{
  "Errors": [
    {
      "Code": "400",
      "ShortText": "HotelCode: Invalid HotelCode ('NT711')"
    }
  ],
  "Status": "Fail"
}

---

Sample Error Response 2

{
  "Errors": [
    {
      "Code": "573",
      "ShortText": "channel-mapping not found for this property!"
    }
  ],
  "Status": "Fail"
}

---

Sample Error Response 3

When error was thrown from booking.com

{
  "Status": "Fail",
  "Errors": [],
  "Message": "Not applicable to resource: Connection request not found - active connection exists",
  "Ruid": "6a549292-135d-4bbb-a4f2-eeaaf592d558"
}

---

Error Response Body Elements

Status string

Indicates the result of the API call, which will be always "Fail" in case of an error response.

---

Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

ShortText string

A short description of the error.

---

Message string

A message providing more information about the error.

---

Ruid string

A unique identifier for tracking the request.