> 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.

Best Practices and Use Cases for Duve PMS API
## Best Practices and Use Cases for Duve PMS API

### Efficient Accommodation Management

Utilize the API to seamlessly create and update accommodation units in the Duve platform:
- Use the 'create' and 'update' events for managing accommodation units
- Include all required fields in the payload (e.g., id, status, name, address details)
- Leverage optional fields for comprehensive property information
- Example: Create a new room with detailed specifications including WiFi credentials and check-in/out times

### Secure Authentication and Rate Limiting

Implement robust authentication and respect rate limits:
- Use bearer token authentication for all API requests
- Send the token via the 'X-Wishbox-Auth-Token' header
- Obtain the API Key and account ID from the Duve connection page
- Handle rate limits (60 requests per minute) to ensure uninterrupted service

### Webhook Integration for Real-time Updates

Leverage webhooks for efficient data synchronization:
- Set up your endpoint in the Duve connection page to receive real-time updates
- Configure to receive POST requests with JSON payloads for various events
- Implement custom headers to verify authenticity of requests from Duve
- Example: Receive instant notifications for new reservations or updates to existing ones
By following these best practices, developers can create robust, efficient, and secure integrations with the Duve PMS API, enhancing the overall guest management experience.

## Use cases
Here are a few use cases of useage with the Duve API that can explain how
you should interact with the Duve PMS API developing your integration.

![alt text](https://connect.duve.com/pub/developers/pms-guest-link-flow.png)

![alt text](https://connect.duve.com/pub/developers/pms-on-boarding-flow.png)

![alt text](https://connect.duve.com/pub/developers/pms-pre-checkin-flow.png)

![alt text](https://connect.duve.com/pub/developers/pms-pre-checkin-scan-document-flow.png)

![alt text](https://connect.duve.com/pub/developers/pms-pre-checkout-flow.png)

![alt text](https://connect.duve.com/pub/developers/pms-sync-booking-flow.png)