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
        • POSTReservation
    • 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 APIPMSReservation

Reservation

POST
https://sandbox.duve.com/api/v1/hooks/reservation/connect
POST
/api/v1/hooks/reservation/connect
$curl -X POST https://sandbox.duve.com/api/v1/hooks/reservation/connect \
>     -H "Content-Type: application/json" \
>     -d '{
>  "accountId": "{{accountId}}",
>  "event": "create",
>  "entity": "reservation",
>  "resource": {
>    "id": "yourSystemReservationId",
>    "status": "NEW",
>    "createdAt": "2019-03-17T13:49:36Z",
>    "primaryGuest": {
>      "firstName": "string",
>      "lastName": "Alex",
>      "email": "alex@airbnb.com",
>      "phone": "+33 3434343434",
>      "language": "fr",
>      "country": "FR"
>    },
>    "unitReservations": [
>      {
>        "id": "1154464678",
>        "adults": 2,
>        "checkin": "2019-05-10",
>        "checkout": "2019-05-11",
>        "unitId": "1212324232",
>        "unitName": "Beautiful large - Two bed rooms - Kind",
>        "children": 2,
>        "babies": 0,
>        "estimatedCheckInTime": "12:00",
>        "estimatedCheckOutTime": "17:00",
>        "unitRoomTypeId": "12345",
>        "unitRoomTypeCode": "stg",
>        "unitRoomTypeName": "Standard room",
>        "price": 150,
>        "paidAmount": 0,
>        "status": "MODIFIED",
>        "currency": "EUR",
>        "doorCode": "",
>        "buildingCode": "",
>        "codeReleased": false,
>        "comments": "This is a comment",
>        "guestComments": "This is a guest comment",
>        "checkInOutComments": "This is a check in check out comment",
>        "additionalFields": [
>          {
>            "fieldName": "NEW FIELD",
>            "content": "Today is Sunday, September 03"
>          }
>        ],
>        "guests": [
>          {
>            "firstName": "Alex",
>            "country": "FR",
>            "email": "alex@airbnb.com",
>            "phone": "+33 2323232323"
>          },
>          {
>            "firstName": "Richard",
>            "lastName": "Bom",
>            "country": "US",
>            "language": "en",
>            "email": "richard@airbnb.com",
>            "phone": {}
>          }
>        ]
>      },
>      {
>        "id": "115555565",
>        "adults": 2,
>        "checkin": "2018-05-09",
>        "checkout": "2018-05-11",
>        "unitId": "123456",
>        "unitName": "One double bed room - with sofa",
>        "children": 1,
>        "babies": 0,
>        "unitRoomTypeId": "123456",
>        "unitRoomTypeCode": "stg2",
>        "unitRoomTypeName": "Standard room2",
>        "price": 120,
>        "paidAmount": 100,
>        "status": "OPEN",
>        "currency": "EUR",
>        "guests": [
>          {
>            "firstName": "Jenny",
>            "country": "PT",
>            "email": "luara@duve.co",
>            "phone": {}
>          }
>        ],
>        "additionalCharges": [
>          {
>            "title": "Tax",
>            "amount": 25,
>            "amountPerDay": true
>          },
>          {
>            "title": "Drinks",
>            "amount": 40
>          }
>        ]
>      },
>      {
>        "id": "1153333678",
>        "adults": 0,
>        "checkin": "2018-05-09",
>        "checkout": "2018-05-11",
>        "unitId": "123333",
>        "unitName": "One double bed room - with sofa",
>        "children": 0,
>        "babies": 0,
>        "price": 120,
>        "status": "CANCELED",
>        "currency": "EUR",
>        "guests": []
>      }
>    ],
>    "channelReservationId": "HTK9085122",
>    "channelName": "bookingcom",
>    "channelId": 7,
>    "channelId2": 8,
>    "marketSegment": "INT",
>    "agent": "AgentName",
>    "membership": "membershipName",
>    "ratePlan": "ratePlanName",
>    "id2": "yourSecondSystemReservationId",
>    "bookedAt": "2019-03-17T13:49:36Z",
>    "updatedAt": "2018-04-17T13:50:29Z"
>  }
>}'
1{
2  "newReservations": 1,
3  "updatedReservations": 0,
4  "skippedReservations": 0,
5  "summary": "WishboxConnect reservations sync completed, synced 0 skipped 0",
6  "reservationIds": [
7    "yourSystemReservationId-1154464678",
8    "yourSystemReservationId-115555565",
9    "yourSystemReservationId-1153333678"
10  ]
11}
Create or update an reservation in Duve
Was this page helpful?
Previous

Webhooks

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.
newReservationsinteger
Number of new reservations synced.
updatedReservationsinteger
Number of updated reservations synced.
skippedReservationsinteger
Number of reservations skipped during the sync.
summarystring
Summary of the sync process.
reservationIdslist of strings
List of reservation IDs processed in the sync.

Errors

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