Sign in
Packages

Create a price rule for a package

Adds a new PriceRule to a Package. Combine date ranges, time windows and weekday filters to express most pricing scenarios — peak vs off-peak, weekday vs weekend, seasonal overrides. The first rule whose conditions match a given booking wins. Sending no filters creates a fallback "always applies" rule.

date_from defaults to today in the site's timezone when omitted. When offering_standard_price is enabled for the site, the package's standard_price must be set before a price rule can be created. A zero amount counts as set. Requires the SETTINGS_MANAGE permission on the package's site.

post/shop/packages/{packageId}/price-rules

Request body

priceinteger required

Price in the smallest currency unit (e.g. pence, cents). 20000 means £200.00 in a GBP-denominated site.

date_fromstring date nullable

First date this rule applies (inclusive). Defaults to today in the site's timezone when omitted.

date_tostring date nullable

Last date this rule applies (inclusive). When omitted, the rule has no end date.

time_fromstring nullable

Start of the time-of-day window in 24-hour HH:MM format. When time_to is set, must be earlier than time_to (the rule does not wrap past midnight).

time_tostring nullable

End of the time-of-day window in 24-hour HH:MM format. Must be later than time_from if both are set.

weekdaysstring[]

Days of the week this rule applies on. Empty / omitted means every day.

Example request

{
  "price": 20000,
  "date_from": "2026-06-01",
  "date_to": "2026-08-31",
  "time_from": "10:00",
  "time_to": "14:00",
  "weekdays": [
    "saturday",
    "sunday"
  ]
}

Response

A single PriceRule belonging to a Package.

Example response

{
  "data": {
    "price": 4800
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.