Vrbo API FAQ and troubleshooting

Purpose Understand common Vrbo (API) behavior, requirements, and limitations, and troubleshoot common listing sync and rate-plan mapping warnings.
Best for Admins, General Managers, and Property Owners managing or evaluating a Vrbo (API) connection.
Use this when You have questions about Vrbo (API) features, onboarding, payments, reservations, listing sync errors, or missing rate-plan mappings.
Requirements For listing sync and rate-plan troubleshooting, the Vrbo (API) channel must already be configured so you can access Accommodation Details and Rate Plan Mapping.
Expected result You can identify the applicable Vrbo behavior or warning, complete supported self-service troubleshooting, and know when Cloudbeds or Vrbo assistance is required.
Limitations Vrbo (API) accepts only one mapped rate plan per listing. Some Vrbo-side listing issues cannot be resolved directly in Cloudbeds PMS and may require assistance from Cloudbeds Support or Vrbo.

Introduction

Vrbo (API) connects Cloudbeds PMS with Vrbo to exchange supported listing content, availability, rates, restrictions, and reservation information. This FAQ explains common Vrbo (API) capabilities and requirements, onboarding and status behavior, payment and reservation behavior, and customer-facing troubleshooting for listing sync and rate-plan mapping warnings.

If you need to set up or configure the connection itself, follow Connect VRBO API for the complete connection workflow.

Table of contents

Vrbo API features and requirements

Use these FAQs to understand the supported Vrbo (API) functionality, Master Brand requirements, room inventory behavior, and payment-collection limitations before or while managing the connection.

Which features does Vrbo API support?

Vrbo API supports:

  • Close Days
  • Closed to Arrival
  • Closed to Departure
  • Minimum length of stay
  • Maximum length of stay
  • Credit Cards
  • Pet fee mapping
  • Cancellations
  • Booking Cutoffs
  • Per Person Pricing
  • Content Management

Vrbo API does not support:

  • Advanced Channel Rates
  • Last-Minute Booking

What is a Master Brand, and what are the requirements for the Vrbo API integration?

A Master Brand determines the country, language, and currency used for your Vrbo listing. Your listing content and currency must match the requirements of the Master Brand assigned to the property.

  1. Language requirements: Provide listing content in the native language of the Master Brand site. For example, listings assigned to Abritel in France must provide content in French.
  2. Currency requirements: Use the currency required by the Master Brand. The currency selected in Cloudbeds should match the currency established with Vrbo.

  Vrbo supports the following currencies for the Master Brands listed here: USD, CAD, EUR, GBP, AUD, NZD, and JPY.

Use the Master Brand table below to confirm the required language and currency.

Master Brand site Language Currency
Abritel (France) French (fr) EUR
Fewo-Direkt (Germany) German (de) EUR
Vrbo (Austria) German (de) EUR
Vrbo (New Zealand) English (en) NZD
Vrbo (England) English (en) GBP or EUR
HomeAway (US) English (en) USD or CAD
Vrbo (Australia) English (en) AUD
Vrbo (Spain) Spanish (es) EUR
Vrbo (Italy) Italian (it) EUR
Vrbo (Japan) Japanese (ja) JPY
Vrbo (Portugal) Portuguese (pt) EUR
Vrbo (Singapore) English (en) USD
Vrbo Admin (US) English (en) USD or CAD

The image below shows the Vrbo Master Brand sites, site IDs, countries, languages, and supported currencies for reference.

Vrbo Master Brand reference showing site, site ID, country, language, and currency 

  Not sure which Master Brand applies? Contact your Vrbo Engagement Manager before changing the listing language or currency.

Can I sync multiple units of the same room type on Vrbo API?

Yes. Unlike a Vrbo iCal connection, the Vrbo API sends Vrbo the total number of available units for the Cloudbeds accommodation type.

Does Vrbo API support channel payment collect?

Vrbo API supports Hotel Collect, not Channel Collect. If your property currently uses a Vrbo iCal connection with Channel Collect and is moving to the Vrbo API, change the payment-collection method so the property can process payments for Vrbo API reservations.

Vrbo connection and onboarding

Use these FAQs when you are waiting for Vrbo to activate the connection, adding another accommodation to an existing connection, or need to contact Vrbo directly.

Why does the Vrbo channel have a Pending status?

A Pending status means the Cloudbeds setup has reached the stage where Vrbo must complete its onboarding and review the connection on the Vrbo side.

After you complete the required Cloudbeds setup steps, Vrbo provides a Self-Service Onboarding link so you can complete the Vrbo onboarding form and any final steps required by your Vrbo Onboarding Manager.

How do I connect a new Vrbo listing?

You can configure a new Cloudbeds accommodation, or an existing accommodation that has not yet been configured for Vrbo, through the Accommodation Details step of the Vrbo (API) channel setup.

Follow Connect VRBO API for the complete setup, accommodation configuration, and onboarding workflow.

How can I contact Vrbo?

Use the regional Vrbo contact information below when you need assistance directly from Vrbo.

Region Phone Vrbo help Email
US +1-877-239-2592 Vrbo US support Not listed
DE +49-69380789474 Fewo-Direkt support Not listed
UK +44-800-032-5708 Vrbo UK support Not listed
FR +33-4-13-68-10-44 Abritel support Not listed
ES +34-911-238-313 Vrbo Spain support Not listed
IT +39-0680335200 Vrbo Italy support Not listed
PT +351-213-665-077 Vrbo Portugal support Not listed
AU +1-800-422-276
9 am to 4 pm
Vrbo Australia support pm-support@homeaway.com.au
NZ +64-99-097-879
11 am to 6 pm
Vrbo New Zealand support pm-support@homeaway.co.nz

Vrbo listing sync and rate-plan mapping

Use these FAQs when the Vrbo channel setup shows a listing sync warning or indicates that one or more accommodations are missing a rate-plan mapping. The exact warning determines which action to take.

Why do I see "Some accommodations have sync errors" in Vrbo?

The message Some accommodations have sync errors is an overview notification. It means that at least one Vrbo accommodation requires attention.

Open Accommodation Details and locate the affected accommodation. Check the exact inline warning before making changes because different warnings have different resolutions.

The Vrbo channel setup overview shows which setup steps contain accommodations that need attention.

Vrbo channel setup overview showing warnings for accommodations with sync errors and accommodations missing a rate plan mapping 

  A warning may disappear from the channel overview and appear again after you open and exit Accommodation Details. Re-open the step before confirming that the issue is resolved.

What should I do if my previously selected Vrbo rate plan was deleted?

If an accommodation shows Your previously selected rate plan has been deleted. Go to the Rate Plan Mapping step to choose a valid one., the Cloudbeds rate plan previously mapped to that Vrbo listing is no longer available.

The affected listing cannot continue syncing rates correctly until a valid rate plan is mapped again.

  1. Go to Distribution → Vrbo (API) → Rate Plan Mapping.
  2. Locate the affected accommodation.
  3. Open the rate-plan dropdown. The previous mapping should appear empty or unselected.
  4. Select a valid rate plan. The Base Rate can be selected.
  5. Click Save.
  6. Confirm that the mapping is restored and the warning clears.

  Vrbo (API) accepts only one mapped rate plan per listing.

What should I do if Vrbo says "This accommodation type requires attention"?

The warning This accommodation type requires attention. Please contact support for more information. is a general Vrbo sync error. The message itself does not identify the exact cause.

Try re-syncing the accommodation first:

  1. Go to Distribution → Vrbo (API) → Accommodation Details.
  2. Open the affected accommodation.
  3. Click Save without changing any values.
  4. Exit Accommodation Details.
  5. Re-open Accommodation Details.
  6. Confirm whether the Sync Error cleared.

If the warning clears, no additional troubleshooting is required.

  If the warning remains after you re-save the accommodation, contact Cloudbeds Support. Before contacting Support, gather the affected accommodation name, the exact warning shown, a screenshot of the warning if possible, and mention that you already tried re-saving the accommodation.

Cloudbeds Support may need to confirm whether the remaining issue must be resolved with Vrbo.

Why do I see "Some accommodations are missing a rate plan mapping"?

The message Some accommodations are missing a rate plan mapping means that at least one Vrbo accommodation does not currently have a valid rate plan selected.

Open Rate Plan Mapping, locate the affected accommodation, select a valid rate plan, and click Save. If the warning was caused by a previously deleted rate plan, follow the same remapping process described above.

Vrbo reservations and error notifications

Use these FAQs to understand how reservation changes synchronize with Vrbo and how Vrbo or Cloudbeds may surface listing and account issues.

Why are Vrbo API reservations not canceled or modified immediately?

Canceling or modifying a Vrbo API reservation is not always immediate. When a reservation is canceled in Cloudbeds PMS, it may take up to 24 hours for the updated status to appear on Vrbo.

If a Vrbo API reservation is modified in Cloudbeds PMS, revised stay dates can update on Vrbo, but a payment already processed by Vrbo does not automatically change. The property is responsible for any required payment adjustment or refund.

Why do I receive error emails from Vrbo?

Vrbo may send properties email notifications about listing or account issues. These emails can provide additional information about items that require attention on the Vrbo side.

Cloudbeds may also display Vrbo sync warnings directly in the channel setup. If Cloudbeds shows a Sync Error, check the exact warning shown for the affected accommodation and use the Vrbo listing sync and rate-plan mapping guidance in this article.

If the issue described in the email is specific to the Vrbo account or Vrbo-side onboarding, use the regional contact information under How can I contact Vrbo?.


Now that you understand common Vrbo API behavior and troubleshooting paths, review these resources for adjacent information about property identification and distribution configuration:

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.