> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.duve.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.duve.com/_mcp/server.

The Duve PMS API is designed for seamless integration between your property management system and Duve’s platform. It enables real-time data synchronization, workflow automation, and enhanced guest experiences by combining the capabilities of your PMS with Duve's tools. This document provides detailed instructions, available endpoints, and best practices to optimize property management. Start integrating today to streamline operations, manage reservations, and elevate guest journeys efficiently.

![image info](https://connect.duve.com/pub/developers/pms-api.png)

## Gettings started

On your Duve platform account create a new sync source of type **Duve pms
Connect** - navigate to settings -> connections -> pms and channel managers -> add new source

In case you are missing this type of sync source please contact our
[integration team](mailto:integrations@duve.com)


Authentication is done through a bearer token sent via
'X-Wishbox-Auth-Token' header on every request to Duve API. You can view
your application token through [Your Duve
account](https://sandbox.duve.com).


Your API Key and the account id can be found in the [connection
page](https://sandbox.duve.com/settings?tab=connections&subTab=syncSources)
in Duve

![alt text](https://content.pstmn.io/a313f8b8-a9c9-49e6-b062-77df7c7b3aa1/aW1hZ2UucG5n)

## Webhooks

In order to recieve data from Duve inside your [connection
page](https://frontdesk.duve.com/settings?tab=connections&subTab=syncSources)
add your endpoint that should recieve a POST request with JSON payload.

You can also add custom headers to the requests to verify that requests
have been recieved from Duve.

![alt text](https://content.pstmn.io/f1c2ebac-6803-4ca6-8dfe-6e6cbe3eaac9/aW1hZ2UucG5n)

### Events
#### Reservation Created
Triggered when a reservation is created in Duve, reservation that synced from the PMS that related to the sync source.
#### Pre Check-in Done
Fires when the guest completes the pre-check-in process, providing details like verified guest information and custom question responses.
#### Pre Check-out Updated
Sent after the first step of pre-check-out is completed, containing estimated check-out times and initial guest feedback.
#### Pre Check-out Done
Triggered when the pre-check-out process is fully completed, including final guest feedback and ratings.
#### Guest Document Uploaded
Notifies when a document (e.g., passport, e-signature) is uploaded by the guest.
#### Guest Link Opened
Indicates when a guest opens their personalized guest link.
#### Order Created
Fires when an order is created, including details like order name, delivery time, and payment status.
#### Order Cancelled
Triggered when an order is canceled, providing related booking and (edited) 
#### Message Sent
Triggered when a host or guest sends a message in the Communication Hub.