For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Support center
HomeGuidesAPI referencesChange log
HomeGuidesAPI referencesChange log
  • PMS API
    • Introduction
    • Best practices
    • Error manual
        • POSTAccommodation
    • Webhooks
  • Duve Connect
    • Introduction
    • Best practices
    • Outgoing webhooks
    • Incoming Duve Connect
  • Open API
    • Introduction
    • Best practices
    • Error manual
    • Rate limit
    • Postman guide
Support center
LogoLogo
PMS APIPMSAccommodation

Accommodation

POST
https://sandbox.duve.com/api/v1/hooks/accommodation/connect
POST
/api/v1/hooks/accommodation/connect
$curl -X POST https://sandbox.duve.com/api/v1/hooks/accommodation/connect \
>     -H "Content-Type: application/json" \
>     -d '{
>  "accountId": "12345",
>  "event": "create",
>  "entity": "accommodation",
>  "resource": {
>    "id": "room_123",
>    "status": "ACTIVE",
>    "name": "Room 2323",
>    "street": "Champs-Élysées",
>    "streetNumber": "66",
>    "country": "FR",
>    "city": "Paris",
>    "wifiName": "DemoWifi",
>    "wifiCode": "dummypass1234",
>    "doorCode": "#Your rental door code",
>    "apartmentNumber": "4",
>    "floor": "4",
>    "state": "",
>    "area": "",
>    "postalCode": "2323 ZE",
>    "buildingEntrance": "B",
>    "buildingCode": "#Your entrance code",
>    "minimumCheckInTime": "14:00",
>    "maximumCheckOutTime": "11:00",
>    "bedroomsNumber": 2,
>    "numberOfToilets": 1,
>    "numberOfBathrooms": 1,
>    "maxNumberOfGuests": 1,
>    "propertyType": 14,
>    "coordinates": {
>      "lat": 48.8709165,
>      "lon": 2.305427
>    },
>    "checkInOptions": [
>      "5b2f7cffdfc0e8591b0e0016"
>    ],
>    "lateCheckOutOverride": false,
>    "bedTypes": [
>      {
>        "bedType": 2,
>        "amount": 1
>      }
>    ],
>    "additionalFields": [
>      {
>        "fieldName": "NEW FIELD",
>        "content": "Today is Sunday, September 03"
>      }
>    ],
>    "sizeSqM": 55,
>    "roomType": {
>      "id": "12345678",
>      "name": "Superior queen room",
>      "code": "stg4",
>      "description": "This is a Superior queen room type",
>      "features": [
>        "phone",
>        "wifi",
>        "sea view"
>      ],
>      "sizeSqM": 60,
>      "numberOfToilets": 2,
>      "bedroomsNumber": 3,
>      "additionalFields": [
>        {
>          "fieldName": "TestName3",
>          "content": "test2"
>        }
>      ]
>    }
>  },
>  "apiToken": {
>    "type": "string",
>    "example": "************"
>  }
>}'
1{
2  "savedProperties": 1,
3  "skippedProperties": 0,
4  "summary": "WishboxConnect properties sync completed, synced 1 properties"
5}
Create or update an accommodation in Duve
Was this page helpful?
Previous

Reservation

Next
Built with

Request

This endpoint expects an object.
accountIdstringRequired
The source id that you recieved in Your Duve account.
eventenumRequired
Allowed values:
entityenumRequired
Allowed values:
resourceobjectRequired
The entity payload body

Response

Webhook received and processed successfully.
savedPropertiesinteger
Number of properties successfully saved during the sync.
skippedPropertiesinteger
Number of properties skipped during the sync.
summarystring
Summary of the synchronization process.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error