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.

circle-info

Allowable value:

  • active → Activates the promotion


Sample Request


Response


Success Response - Body Elements

Status string

Indicates the result of the API call.

circle-info

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


Errors Response - Body Elements


Status string

Indicates the result of the API call.

circle-info

"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.

Last updated

Was this helpful?