Activate Promotion API

Updates the status of an existing promotion to active without modifying its configuration.

---

Endpoint

POST

https://connect.su-api.com/SUAPI/jservice/bdc/promotion/updateStatus

Attributes

hotel_id string (Required)

Specifies the required node hotel_id contains the IT provider's hotel id for which the provider wishes to activate promotion.

---

channel_hotel_id string (Required)

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

---

promotion_id string (Required)

Enter the promotion ID to update.

---

status string (Required)

Defines the new status of the promotion.

Allowable value:

• active → Activates the promotion

---

Sample Request

{
  "hotel_id": " Test ",
  "channel_hotel_id": "13130615",
  "promotion_id": "TB464408707554684447",
  "status": "active"
}

---

Response

Success Response

{
    "Status": "Success",
    "Message": "Promotion Activated successfully",
    "Ruid": "fa198d07-d16c-4773-852d-1b9895ea172d",
    "Data": {
        "promotion_id": "TB464408707554684447"
    }
}

---

Success Response - Body Elements

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

---

Message string

A message receives within the response body. This will generally be an empty string if no additional information is needed.

---

Ruid string

Specifies the unique request ID.

---

Data object

An object containing data related to the successful promotion creation. This typically includes identifiers for the created promotions.

---

promotion_id string

The activated promotion ID.

---

Errors Response - Body Elements

Sample Error Response 1

{
   "Status": "Fail",
   "Errors": [],
   "Message": "(ID_NOT_FOUND) Promotion with id 'TB4644087075546844478' was not found for hotel",
   "Ruid": "d3ceb8dd-daf9-498e-b601-41ab5976bbed"
}

Sample Error Response 2

---

Errors Response - Body Elements

---

Status string

Indicates the result of the API call.

"Fail" – The request was not processed successfully due to validation errors or other issues.

---

Errors array[object]

A list of error objects providing detailed information about one or more issues encountered during request processing. This field may be empty if the error is conveyed through the Message field.

---

Code string

A unique error code representing the specific type of validation or processing error.

---

ShortText string

A brief, human-readable description of the error. Typically explains what went wrong and may include accepted values or constraints.

---

Message string

A descriptive error message summarizing the failure.

---

Ruid string

A unique request identifier generated for tracking and debugging purposes. This value should be provided when contacting support for issue investigation.