Overview
Once the integration is available, the steps below will be used on how to create promo codes from Hostfully.
Step 1: Access the Promo Codes Page
Log in to your Hostfully PMP account.
Select Promo Codes from the drop-down menu.
Click Add Promo Code.
Step 2: Fill in the Promo Code Details
Complete the following fields when creating your promo code:
Name (required) — Letters and numbers only. This is what you'll share with guests, so make it meaningful and easy to remember (e.g.,
WELCOME10). Note: promo code names must be unique — you cannot create a code with a duplicate name.Property — Select All Properties or a specific property the code can be redeemed for.
Type — Choose whether the discount is a fixed amount or a percentage.
Amount (required) — The discount value to be applied.
Expiration Date (required) — The last date the code can be redeemed by a guest. This is independent of the validity date range. Use this to create urgency — for example, offer a summer discount but set the code to expire at the end of June so guests are prompted to book sooner.
Validity Date Range (Start date and End date) — The check-in dates for which the code is valid. Note: the validity range is exclusive of the start and end dates themselves. If you enter 6/25 - 7/18, guests checking in on 6/25 or checking out on 7/18 will not receive the discount. Also, do not select Today as the start date — choose a date after today to avoid an error.
One-time usage — If checked, the code can only be redeemed once across all guests. If left unchecked, it can be used for all applicable bookings.
Once created, the code will appear on the Promo Codes page, where you can filter codes by status:
Active — Codes that haven't expired, have a valid date range, and (if single-use) haven't been redeemed yet
Expired — Codes that have passed their expiration date or are outside the valid date range
Redeemed — Single-use codes that have already been redeemed by a guest
Deleted — Codes that have been deleted
Important Note: This field will only display if there is at least one valid promo code that applies to both the property and the dates the guest has selected.
How Guests Will Apply the Code on Your CraftedStays Site
Once Hostfully enables API support for discount codes and CraftedStays updates the integration, guests will be able to enter promo codes during the booking flow on your CraftedStays direct booking site. Here's how it will work:
The guest searches for available dates and selects a property.
A Promo Code field will appear at the bottom of the booking widget — but only if there is at least one valid code that applies to both the selected property and the selected dates.
The guest enters the promo code. Hostfully validates it and automatically applies the discount to the booking price.
The discount appears as a separate line item in the booking summary. Note: the discount is applied to the rent amount only — not to fees or taxes.
We will update this article as soon as this functionality becomes available.
Discount Codes and Payments Are Managed in Hostfully
Everything related to promo codes and payments lives entirely within your Hostfully account — not in CraftedStays. Here's how the responsibilities are split:
CraftedStays | Will display the Promo Code field to guests during the booking flow once Hostfully API support is available |
Hostfully | Creates and manages promo codes, validates codes at checkout, calculates and applies discounts, and processes guest payments |
If you need to edit, deactivate, or track usage of your promo codes, all of that is handled from your Hostfully PMP account under Promo Codes. CraftedStays does not have the ability to create, modify, or troubleshoot promo codes on your behalf.
Tips
Use distinct codes per campaign (e.g.,
SUMMER10for a seasonal promo,EMAIL10for newsletter subscribers) so you can track which channels are driving bookings.Use the expiration date strategically to create urgency — offer a discount valid for future dates but set the code to expire soon so guests are motivated to book now.
Enable one-time usage for exclusive or VIP codes to control redemption.
Track redeemed codes in your Hostfully reports under the Discount column.
FAQs
I'm getting an "Error while creating promo code, please try again" message.
This usually happens when Today is selected as the Start date of the validity range. Select a date after today instead.
Related Resources