This article explains how to connect your Better Hotel PMS account to Duve. Better Hotel connects to Duve through the Duve Connect API: Duve generates an API key and an account ID for you, Better Hotel uses them to push your rentals and reservations into Duve, and Duve sends guest activity back to Better Hotel through webhooks. You need an active Duve account to complete the setup.

Quick navigation:

• Applies to
• Use cases
• Before you start
• How to set it up
  • Step 1: Create the Better Hotel source in Duve
  • Step 2: Copy your API key and account ID
  • Step 3: Send the details to Better Hotel
  • Step 4: Enable the 2-way integration (webhooks)
• How to add new rentals from Better Hotel to Duve
• Troubleshooting
• Restrictions & Limitations
• FAQs
• Related article

Use cases

• Automatically import your Better Hotel rentals and reservations into Duve, so guests get their online check-in and Guest app links without manual data entry.
• Send online check-in results, uploaded guest documents, and upsell orders back to Better Hotel, so your front desk works from one up-to-date record.
• Keep reservation changes and cancellations made in Better Hotel in sync with Duve.

Before you start

• Make sure you have an active Duve account and have selected Better Hotel as your PMS.
• Have access to your Better Hotel account at https://app.better-hotel.com.
• Better Hotel completes its side of the connection, so you will need to contact Better Hotel support at info@better-hotel.com.

How to set it up

Step 1: Create the Better Hotel source in Duve

1. In Duve, go to Settings > General > Connect & Sync.
2. Select Better Hotel and click Connect.

Duve creates a new Better Hotel source and generates a unique API key and account ID for it. The connection page also shows a short step-by-step guide.

Step 2: Copy your API key and account ID

1. On the Connect & Sync section, click the new Better Hotel source row.
2. Copy the API Key and the Account ID. Click each value to copy it to your clipboard.

Step 3: Send the details to Better Hotel

1. Email your API Key and Account ID to Better Hotel support at info@better-hotel.com.
2. Better Hotel adds the details to your Better Hotel account and verifies that the connection works.

Once Better Hotel confirms the connection, your rentals and reservations start syncing into Duve.

Step 4: Enable the 2-way integration (webhooks)

Webhooks let Duve notify Better Hotel when something happens on a reservation, such as a completed online check-in or a new upsell order.

1. In Duve, go to Settings > General > Connect & Sync.
2. Click the Better Hotel source.

3. In the Webhooks section, click + Add new.

   

4. In the Endpoint URL field, enter the Better Hotel webhook URL: [PLACEHOLDER: Better Hotel webhook endpoint URL, to be provided by Better Hotel]
5. In the events field, select the events you want Better Hotel to receive (for example, Pre Check-in Done or Guest Document Uploaded).
6. Optional: under Headers, click Add header to add any header name and value Better Hotel asks for.

7. Click Save.

   

8. In the What we sync section of the same page, make sure the Basic 2-way connection toggle under Write permissions is on.

Once these steps are done, Better Hotel and Duve are synced. Your rentals appear on the Rentals page and your reservations appear on the Reservations page.

How to add new rentals from Better Hotel to Duve

You do not need to add new rentals manually. When you create or update a rental in Better Hotel, Better Hotel pushes it to Duve automatically. A rental also appears in Duve the first time a reservation for it is synced.

Troubleshooting

• Rentals or reservations do not appear in Duve: check that the Better Hotel source status in Duve is active. While a source is still waiting for onboarding, Duve accepts but skips data sent by Better Hotel. Contact Duve support if the source stays in this state.
• Data stopped syncing after you refreshed the API key: Duve only accepts data sent with the current API key. Send the new key to Better Hotel (see the FAQs below).
• Better Hotel does not receive guest updates: open the Better Hotel source in Duve and check that the Endpoint URL is correct, the relevant events are selected, and the 2-way toggle is on.

Restrictions & Limitations

• Data sent by Better Hotel is rejected if your Duve subscription or trial has expired.
• If online check-in or online check-out is not active on your account, the related webhook events (such as Pre Check-in Done or Pre Check-out Done) are not available to select.
• The 2-way connection toggle is not shown if 2-way sync is not available on your plan.
• Duve does not pull data from Better Hotel. If Better Hotel does not send an update, Duve will not show it.
• Reservations with a check-in date later than the check-out date are not imported.
• Estimated check-in/check-out times and rental check-in/check-out times are only saved when they match Duve's time options.
• Additional fields are only synced when a field with the same name exists and is enabled in your Duve account (and matches the rental's brand, if the field is limited to specific brands).
• If Duve cannot deliver a webhook, it retries up to 5 times.

FAQs

Q: Do I need to enter a username or password from Better Hotel in Duve?
A: No. Duve generates the API key and account ID for you. You only need to send them to Better Hotel.

Q: What happens if I click Refresh token on the Better Hotel source?
A: Duve generates a new API key and the old one stops working right away. Send the new key to Better Hotel at info@better-hotel.com so syncing can continue.

Q: How long does it take for the connection to start working?
A: Syncing starts once Better Hotel adds your API key and account ID and verifies the connection. 

Q: Can I send webhooks to more than one URL?
A: Yes. You can add several webhooks, each with its own endpoint URL, events, and headers.

Q: Where can I see exactly what data is synced?
A: See the Better Hotel PMS | Integration Specs article.

Q: Are folio charges synced?
A: Not as a folio. Duve receives the reservation price, the paid amount, and any additional charges Better Hotel sends.

Q: Are canceled reservations removed from Duve?
A: No. When Better Hotel marks a reservation as canceled, Duve updates its status to Canceled.

Q: Can I add custom headers to the webhooks sent to Better Hotel?
A: Yes. You can add any header name and value when you create or edit a webhook.

Q: Does Duve create a guest profile from Better Hotel reservations?
A: Yes. The main guest's name, email, phone, country, and language are used to create or match a guest profile in Duve.

Related article:

Better Hotel PMS | Integration Specs