Connect Homes & Villas by Marriott Bonvoy (HVMB) to Beds24 to create listings, update their content, send your availability and prices, and import bookings. HVMB is a curated collection of professionally managed vacation rentals from Marriott International.
Quick Guide
- Apply to list with Marriott and get your HMCID.
- In Settings > Channel Manager > Marriott Homes & Villas, enter your HMCID and adjust your Beds24 security settings.
- Fill in Specific Content and fix any content errors under View Content.
- Set Enable = Enabled, save, and click Send to Marriott.
Table of Contents
- Capabilities and limitations
- Requirements to list with Marriott
- Before you connect
- Security requirements
- Create listings on Marriott Homes & Villas
- Update existing listings
- Content
- Promotions
- Troubleshooting
- Disconnect
Capabilities and limitations
- Beds24 creates listings on Homes & Villas by Marriott International and updates their content.
- Beds24 exports availability and prices, and imports bookings.
- Marriott doesn't allow 1-night stays: the minimum stay is 2 nights, and 1-night prices aren't sent.
- Marriott only works with property managers, not individual properties.
- Bookings imported from HVMB don't have detailed fee or tax information, only the type and total value of each fee or tax.
- Upsell items can't be exported.
For the full list, see Channel Manager Capabilities.
Requirements to list with Marriott
Your property management company and your properties must meet Marriott's standards.
Property managers:
- Handle the management, in-stay guest support and cleaning of at least 30 properties (with some exceptions for various markets and offerings).
- Are responsible for updating calendar availability and pricing.
- Have a track record of reliability and customer satisfaction, including response times, compliance with local regulations and other management responsibilities.
Properties:
- One or more bedrooms (no studios or home shares).
- A fully equipped kitchen, wifi, linens, towels, bathroom amenities and other essentials.
- Safety equipment, including smoke and carbon monoxide detectors and fire extinguishers.
If you meet these requirements, complete the Homes & Villas by Marriott International listing form.
Before you connect
- Sign up with Marriott Homes & Villas with the Marriott Homes & Villas company interest form.
- If you're already on Marriott Homes & Villas, ask Marriott to create a new HMCID for Beds24. After you've created your new listings from Beds24, Marriott can attach your historic bookings to them.
- Beds24 only sends availability when you have prices that are active for Marriott under Channels in the daily prices or fixed prices. See Setting Prices for Booking Channels.
Pricing models
| Pricing model | How it works |
|---|---|
| Per Day Pricing (default) | Choose this if you have only one price per date. If several prices with different minimum stays are active for Marriott, the price with the lowest minimum stay is sent; among those, the one with the highest occupancy. Only a global maximum stay, from Settings > Properties > Rooms > Setup, can be sent. If you use daily prices with extra person prices, set the daily price for the maximum occupancy and add the extra person price as a negative value. |
| Per Occupancy (LOS) Pricing | Choose this to send prices for different occupancies or lengths of stay. Fixed prices send a price for each occupancy and length of stay defined in Beds24: the 1 person, 2 person and room price (for the occupancy you specify). Daily prices are sent including occupancy, and the extra person price is sent. The minimum and maximum stay set in the calendar are sent. Extra person and extra child prices, and discounts on the Discounts tab of fixed prices, can't be sent. |
Warning: To send different prices for different lengths of stay, set the room restriction strategy in Settings > Properties > Rooms > Setup to Stay through. With Arrival, the price might be calculated wrongly after the first night. See Room Setup.
With Per Day Pricing, you can set the number of guests the daily price applies to and an extra person price in Settings > Channel Manager > Marriott > Specific Content. For example, for a room for 3 people at €50 for 2 people plus €15 for the third, create a room price of 50 for up to 2 people, then set Guests included = 2 and Extra Person Price = 15.
Properties, rooms and room types
A property in Marriott is a room in Beds24. The name and pictures sent are:
- For properties with one unit: the property name from Settings > Properties > Description and the property pictures.
- For properties with more than one unit type: the names from Settings > Properties > Rooms > Description and the room pictures.
The connection supports room types with a quantity above one. If you sell rentals individually elsewhere but as a room type on Marriott, set up virtual rooms.
Security requirements
Marriott has specific security requirements. In Settings > Account > Access, set Beds24 to:
- Require a password change every three months.
- Use two-factor authentication for your Beds24 account.
- Time out the Beds24 session after 15 minutes.
See How to manage Security. Marriott then sends you a security questionnaire. With these settings in place, you can answer it as follows:
| Question | Answer |
|---|---|
| Does the system use roles to assign permissions and to ensure each user has the least amount of privileges necessary to perform their job function? | Yes |
| If yes, what type of roles are used to control access to guest reservation data? | Admin |
| Are written procedures in place to describe how user access to the PMS is granted, updated and removed? If yes, describe your access control procedures or upload a copy. | Describe how you manage access to Beds24. |
| Do the passwords used to access the PMS require at least 8 complex characters? | Yes |
| Does the PMS support the ability for end users to log in with 2-factor / multi-factor authentication (2FA/MFA)? | Yes |
| Are users' passwords changed at least every 90 days? | Yes |
| Do idle (inactive) sessions of more than 15 minutes require the user to re-enter their password to reactivate the site or application? | Yes |
| Are repeated access (login) attempts limited by locking out the user ID after at least 5 attempts? | Yes |
| Are users prevented from using at least the previous 4 passwords during a password change? | Yes |
Create listings on Marriott Homes & Villas
Minimum content requirements
- A unique listing name (8 to 255 characters).
- Property address, latitude and longitude.
- Bedrooms, including the number and type of beds, and the number of bathrooms.
- A description that doesn't mention the management company name, non-HVMB cancellation policies and similar. If you have a permit ID, add it here or in the house rules.
- A valid property type: Apartment, Cabin, House, Villa, Aparthotel, Barn, Building, Casa Particular, Castle, Chacara, Chalet, Chateau, Condo, Cottage, Cycladic House, Estate, Farmhouse, Lodge, Loft, Mas, Mill, Resort, Riad, Serviced Apartment, Studio, Tower, Townhome or Tree House.
- At least 3 consecutive days of availability and pricing in the next 365 days.
- 6 or more pictures, at least 500 x 800, without watermarks or the management company name.
- 5 or more amenities.
- House rules that don't mention the management company name, contact information, or any cancellation policy of a competing channel or of direct bookings. If you have a permit ID, add it here or in the description.
Step 1: Enter your Marriott HMCID
- Get your user ID (HMCID) from Marriott.
- Click Enter Marriott User ID and enter your HMCID in User ID.
- Click Save.
Step 2: Adjust your security settings
Set the password, two-factor and session time-out settings in Settings > Account > Access, see Security requirements.
Step 3: Enter channel-specific content
Go to Settings > Channel Manager > Marriott > Specific Content to adjust specific settings and add content. You can use line breaks.
Step 4: Check that your content meets Marriott's requirements
Go to Settings > Channel Manager > Marriott > View Content to review the data that will be sent. Settings that don't meet Marriott's requirements are highlighted in red; click the links to fix them. A red Fix Content Errors button means your listing doesn't meet the requirements yet and takes you to View Content.
Step 5: Check which prices will be sent
Click Actual Data to check the prices and availability that will be sent. If you see no prices or availability, check that you have prices active for Marriott.
Step 6: Check the currency
Marriott supports only a few currencies. If your currency isn't supported, add a multiplier for currency conversion (step 7).
Step 7: Add a price multiplier (optional)
To mark your prices up or down, or convert the currency, enter * and the multiplier, for example *1.23 (raises prices by 23%) or *[CONVERT:IDR-EUR] (converts Indonesian rupiah to euros). The multiplier applies to all prices and fees sent. See Price multiplier for all options.
Step 8: Export to Marriott
- When your content meets Marriott's requirements, set Enable = Enabled and click Save.
- Click Send to Marriott, select all options and click Confirm.
Step 9: Check the connection
- Click View actual data and check that the prices are as you expect.
- Give Marriott some time to process the data, then click Update. If Marriott returns an error, see Troubleshooting. If the error isn't listed, send Beds24 a support ticket.
Expected result: Marriott reviews each listing manually before setting it live, which normally takes one working day. After that, Beds24 keeps availability and prices in sync and imports bookings.
Update existing listings
Prices and availability sync automatically. To change the content of a listing, go to Settings > Channel Manager > Marriott, click Send to Marriott and select what you want to update.
Content
Permit IDs
To send permit information, add it in Settings > Channel Manager > Property Content > Room Content > Room Description Text.
Bedrooms and bathrooms
If you don't set up any bedrooms or bathrooms, Beds24 sends one of each by default.
- Go to Settings > Properties > Rooms > Setup and click Edit next to the Features field.
- In the pop-up, click Bedroom or Bathroom, set the type, and use the selectors to define the features in each room. Define all your bedrooms and bathrooms.
- If you have more than 2 rooms, click Close and Save. When you click Edit again, more rooms are added automatically.
- Close the pop-up and click Save.
Warning: Set up bedrooms and bathrooms either on the property or on the room. If you set them up on both, they're doubled. Don't send extra bathroom amenities if you have a full bathroom.
Amenities
Set up amenities for the property (Settings > Properties > Description) or per room (Settings > Properties > Rooms > Setup). Amenities that apply to all rooms go on the property and are applied to every room; amenities that apply to one room go on that room. Don't create duplicates. For example, if all units have cable, set it on the property; if only one unit has cable, set it on that room.
- Click Edit next to the Features field and click Amenities.
- Tick the amenities you provide.
- Close the pop-up and click Save.
Feature codes
You can also add bedrooms, bathrooms and amenities by typing feature codes into the Features field. Marriott doesn't support all Beds24 features; these are the ones it supports.
Bedrooms, beds and bathrooms:
BEDROOM BATHROOM BED_TWIN BED_SINGLE BED_DOUBLE BED_QUEEN BED_KING BED_BUNK BED_MURPHY BED_SOFA BED_TODDLER BED_FUTON BED_CRIB BED_AIRMATTRESS BATH_TUB
Amenities:
BABYSITTING AIR_CONDITIONING BALCONY BASKETBALL_COURT BEACH BEACH_ESSENTIALS BEACH_FRONT CABLE CHECK_IN_OUT_SELF CO_DETECTOR COFFEE_MAKER CONCIERGE DECK_PATIO_UNCOVERED DISHWASHER DRYER ELEVATOR FIRE_EXTINGUISHER FIREPLACE FIRST_AID_KIT FITNESS_CENTER GAME_ROOM GAMES GROCERY_SHOPPING_SERVICE HAIR_DRYER HEATING HIGHCHAIR HOME_STEP_FREE_ACCESS HOT_TUB JET_SKIING LAUNDRY MICROWAVE MOUNTAIN_VIEW OCEAN_VIEW OUTDOOR_FURNITURE OUTDOOR_FIREPLACE OVEN PARKING_DISABLED PARKING_INCLUDED PARKING_INDOOR PARKING_VALET PETS_CONSIDERED PETS_NOT_ALLOWED POOL POOL_HEATED POOL_PRIVATE PRIVATE_CHEF PRIVATE_YARD REFRIGERATOR SAUNA SKI_IN SKI_OUT SKI_STORAGE SMOKE_DETECTOR STOVE TABLE_TENNIS TENNIS TOYS WASHER WATER_SPORTS WATER_VIEW WATERFRONT WHEELCHAIR_YES WIDE_HALLWAY_CLEARANCE
Pictures
Choose which pictures are used in Settings > Channel Manager > Marriott > Specific Content. Marriott requires 6 or more pictures, at least 500 x 800, without watermarks or the management company name.
Taxes and fees
Add taxes and fees for Marriott under Custom in Settings > Channel Manager > Marriott > Specific Content. The context help has the details.
Promotions
Create discounts for any of your HVMB listings. When a promotion's status is enabled, clicking Save sends it to your Marriott listing, where it's available immediately.
Troubleshooting
For general causes and fixes, see Troubleshooting in How the Channel Manager works.
| Error | Cause and fix |
|---|---|
RoomSettings array cannot be missing or empty |
Define the beds in your bedrooms. Go to Settings > Properties > Rooms > Setup, click edit bedrooms and set up each bedroom and its beds. |
Cancellation Policy Category can not be blank |
No fix is documented yet. Send Beds24 a support ticket. |
Account is no longer connected to beds24 |
You may have invalid Marriott listing IDs. Contact Beds24 support and ask to have them deleted. |
Disconnect
- To take your listing offline, set Publish = No in Settings > Channel Manager > Marriott > Specific Content. Then, under Marriott > Mapping, click Send to Marriott and confirm.
- To stop the data exchange, set Enable = Disable in Settings > Channel Manager > Marriott > Mapping.
- To end your cooperation with Marriott, contact Marriott support.