Skip to main content
An offer is one purchasable or requestable item. Offers are workspace-level resources that you can reuse in multiple template layouts. kind controls the behavior. purchase charges at checkout. request places a hold on the guest’s card and charges it only if you approve the request; a free request takes no card. ad opens link_url. Offer edits reach portals already sent.

Flat pricing

Call Create Portal Offer to create an offer:
price_in_cents must be 0 or at least 500 for purchase and request offers without options or a percentage price.

Nightly and daily pricing

price_unit sets how the price counts. per_stay is the default. per_night and per_day multiply the price by the nights or days the guest picks. Set charge_every_night on a per_night offer to charge every night of the stay instead of letting the guest pick. date_selection sets which dates the guest picks: single, multiple or range. per_night and per_day offers always use a range.

Options and time slots

option_groups holds up to 3 groups of up to 12 options. price_in_cents is the base price and each option’s price_in_cents is added to it. An offer with option groups can’t take percent_price. A group’s type is single, multi or counts. Set input_type: "time" and give each option a time_slot (listing-local HH:MM) to let the guest pick a time, such as an early check-in time. On a request offer, reservation_action (check_in or check_out) moves the reservation’s check-in or check-out to the chosen time when you approve the request. It needs a required single group with input_type: "time".
To price each combination of single-choice options separately, set combinations_enabled: true and list every sellable combination in variants. A variant’s price replaces the base price. option_groups, questions and variants replace the full list when you send them.

Questions and order limits

questions asks the guest for notes when they order, for example { "label": "Flight number", "required": true }. max_per_order caps the quantity in one order, from 1 to 20. ad offers open link_url. link_label sets the button text, up to 24 characters.

Payment account

stripe_connection_id sends the offer’s payments to a specific Stripe account instead of the workspace’s payment routing. Setting or changing it requires Manage Portal Payments. Find account IDs in stripe_connections from Get portal settings.

Percentage pricing

percent_price charges a percentage of a booking value:
of accepts totalPrice, averageNightlyRate, averageNightlyRateWithFees or accommodationFare. accommodationFare is the total accommodation fare for the stay, excluding fees and taxes, and averageNightlyRate is that total divided by reservation nights. averageNightlyRateWithFees is the booking total, including fees and taxes, divided by reservation nights, and is never lower than averageNightlyRate. All three are available for supported Guesty, Hostaway, Track and Mews reservations.

Targeting and availability

Offer targeting supports booking channel, reservation source, nights, vacant nights before arrival or after departure (1 to 30), property and listing group, inbox, and contact custom-attribute criteria. Channel names are exact and case-sensitive, for example Airbnb, Booking.com, Vrbo, Expedia and Direct bookings. The following offer requires one vacant night before arrival:
targeting.stayWindow limits when the offer shows relative to the stay. start and end are each an amount of hours or days before the checkIn or checkOut anchor. The following offer shows from 3 days to 2 hours before check-in:
availability uses visibleFrom, visibleUntil, bookableFrom, and bookableUntil.

Archiving

Archive Portal Offer deactivates an offer, removes it from each template layout, and hides it in portals already sent. Each changed template’s version goes up, and an active template left with no blocks becomes a draft. Restore Portal Offer reactivates the offer. It does not restore removed layout blocks.