Update Mobile Only

Updates an existing promotion for a listing, supporting multiple discount types such as BASIC, TIERED, DAY_OF_WEEK, and MULTI_NIGHT, along with booking and stay constraints.

---

Endpoint

POST

https://connect.su-api.com/SUAPI/jservice/vrbo/promotion/update 

---

Attributes

hotel_id string (Required)

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

---

channel_hotel_id string (Required)

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

---

listing_id string (Required)

Unique identifier of the listing for which promotions are updated.

---

promotion_id string (Required)

Unique identifier of the promotion to be updated.

---

status string (Optional)

Defines the lifecycle status of the promotion (e.g., ACTIVE, INACTIVE).

---

type string (Optional)

Specifies the type of promotion (e.g., EARLY_BOOKING, NEW_LISTING_DISCOUNT).

---

discount_type string (Optional)

Defines the type of discount.

Possible values:

• BASIC – Single discount for all users

• TIERED – Member-based tier discounts

• DAY_OF_WEEK – Discounts vary by weekday

• MULTI_NIGHT – Discounts based on number of nights stayed

---

"discount_type" = "BASIC"

discount object (Optional)

---

unit string (Required)

Unit of discount (PERCENT, AMOUNT).

---

value number (Required)

Discount value.

---

min_stay_through integer (Optional)

The minimum number of nights a guest must stay to be eligible for the promotion.

---

max_stay_through integer (Optional)

The maximum number of nights a guest must stay to be eligible for the promotion.

---

book_date object (Optional)

The date range the promotion will appear.

---

Start date (YYYY-MM-DD) (Required)

Start date (YYYY-MM-DD)

---

end date (YYYY-MM-DD) (Required)

End date (YYYY-MM-DD)

---

book_time object (Optional)

The times of day (on dates specified in book_date) the promotion appears on VRBO, in 24-hour format, in the property's timezone.

---

start string (Required) HH:mm:ss (24-hour format)

The time of day (on dates specified in book_date) the promotion will appear on VRBO, in 24-hour format, in the property's timezone.

---

end string (Required) HH:mm:ss (24-hour format)

The time of day (on dates specified in book_date) the promotion will no longer appear on VRBO, in 24-hour format, in the property's timezone.

---

stay_date object (Optional)

Filters promotions based on stay date range.

---

start date (YYYY-MM-DD) (Required)

Start date (YYYY-MM-DD)

---

end date (YYYY-MM-DD) (Required)

End date (YYYY-MM-DD)

---

excluded_dates array[string] (YYYY-MM-DD) (Optional)

A range of dates during which guests staying at the property will not receive the promotion.

---

Sample Request

Sample Request

{
  "hotel_id": "NT7",
  "channel_hotel_id": "5293166",
  "listing_id": "126197121",
  "promotion_id": "01c50616-f5ce-42e4-ad81-9682d9d17084",
  "status": "ACTIVE",
  "type": "MOBILE_ONLY",
  "discount_type": "BASIC",
  "discount": {
    "unit": "PERCENT",
    "value": 10
  },
  "min_stay_through": 1,
  "max_stay_through": 28,
  "book_date": {
    "start": "2026-03-01",
    "end": "2026-12-31"
  },
  "book_time": {
    "start": "00:00:00",
    "end": "23:59:00"
  },
  "stay_date": {
    "start": "2026-05-01",
    "end": "2026-12-31",
    "excluded_dates": [
      "2026-07-01",
      "2026-07-09",
      "2026-07-10"
    ]
  }
}

---

Response

Success Response

{
  "Status": "Success",
  "Data": {
    "promotion_id": "01c50616-f5ce-42e4-ad81-9682d9d17084"
  },
  "Message": "Promotion updated successfully",
  "TrackingId": "803fc046-c1d9-49cf-b339-63f4d4baaf2d"
}

---

Success Response - Body Elements

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

---

Data object

An object containing data related to to fetched promotions. This typically includes identifiers for the created promotions.

---

promotion_id string

Unique identifier of the promotion.

---

Message string

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

---

TrackingId string

Unique identifier for tracing the request.

---

Errors Response - Body Elements

Validation Error

{
  "Errors": [
    {
      "Code": "1257",
      "ShortText": "promotion status is required"
    },
    {
      "Code": "1261",
      "ShortText": "promotion type is required"
    },
    {
      "Code": "1263",
      "ShortText": "discount type is required"
    },
    {
      "Code": "443",
      "ShortText": "discount is required"
    },
    {
      "Code": "1267",
      "ShortText": "min stay through is required and must be numeric and non-negative"
    },
    {
      "Code": "1268",
      "ShortText": "max stay through is required and must be numeric and non-negative"
    },
    {
      "Code": "1295",
      "ShortText": "stay date is required"
    },
    {
      "Code": "1297",
      "ShortText": "stay start date is required and must be a valid date in Y-m-d format"
    },
    {
      "Code": "1298",
      "ShortText": "stay end date is required and must be a valid date in Y-m-d format"
    }
  ],
  "Status": "Fail"
}

Sample Error Response

---

Errors Response - Body Elements

---

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.

---

Status string

Indicates the result of the API call.

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

---

TrackingId string

Unique identifier for tracing the request.