ADD Reservation

AddReservation() allows booking of a specific itinerary for a specific unit or unit group.  AddReservation() supports POST with a JSON request body that details the reservation and guest.  Credit Card information may be provided, but only if you have a current PCI Attestation on file with ResNexus.  DO NOT provide credit card information if you do not wish the property to process the card.


Request Body
     business_id (long int)
         the unique identifier for the property
     check_in (date YYYY-MM-dd)
        the check in date requested
     check_out (date YYYY-MM-dd)
        the check out date requested
     unit_id (int)
        the unique id for the unit requested
    unit_group_id (long int)
        the unique id for the unit group.  Exactly one of unit_id or unit_group_id should be provided
    num_adults (int)
        the number of adults to make the reservation for.  This may affect the rate depending on the property's rate configuration
    customer (object)
         the perspective guests' information.  For this endpoint, first_name, last_name, phone_number, address and email are required
     card_number (string)*
        the credit card number to charge for this reservation
     card_name (string)*
        the name on the card
     card_cvv (string)*
        the CVV for the credit card
     expire_month (int)*
        the two digit month for the credit card's expiration
     expire_year (int)*
        the four digit year for the credit card's expiration
    external_id (string)
        The external_id is the unique identifier of the reservation in your system.  The string must be 25 or less characters in length.  It is free form and is required to modify or cancel the reservation after it is created
    notes_from_partner (string)
        A free-form text field that will be displayed to the property in the reservation notes

*You may only add credit card information in a reservation request if you have a current PCI Attestation on file with ResNexus


>curl  -X POST
--user username:accesskey 
-H 'Content-Type: application/json'
-d '{
              "address_line": "1234 Schmoe St",
     "notes_from_partner":"Your base rate: $300.00 \n Our commission: $45.00 (15%) \n Taxes: $22.50 \n Your payout will be: $232.50 \n Adults: 2 \n Children: 0 \n Pets: 2 \n Vehicle Details: Travel Trailer, 34 feet, passenger slideouts"


response_errors (See Response Errors)
business_id, check_in, check_out, etc
the fields used in the request will be returned in the response
reservation_id (int)
   the reservation's unique id in the property's reservation system
quote (object)
   the quote used to create the reservation.  See GetQuote() to get this object prior to creating the reservation


    "response_errors": [],
    "action": Create
    "business_id": "16609",
    "check_in": "2021-12-21",
    "check_out": "2021-12-23",
    "unit_id": "27795",
    "customer": {
        "first_name": "Joe",
        "last_name": "Schmoe",
        "phone_number": "4445556666",
        "address": {
            "address_line": "123 Schmoe St",
            "city": "Schmotown",
            "state_or_province": "Ohio",
            "country": "USA",
            "postal_code": "12345-98765"
        "email": ""
    "external_id": "FakeReservation001",
    "reservation_id": "244995",
    "quote": {
        "pricing_type": "DirectQuote",
        "check_in": "2021-12-21",
        "check_out": "2021-12-23",
        "available": "Y",
        "base_rate": "200",
        "taxes": "0",
        "fees": "0",
        "unit_id": "27795",
        "booking_link": "",
        "currency": "USD",
        "occupancy": "2",


The credentials supplied are incorrect or you do not have access to this resource
Something went wrong (Internal Server Error)
    Server in maintenance mode


>curl -X POST
--user username:accesskey
-H 'Content-Type: application/json'
-d '{
"business_id": "9999",
"check_in": "2021-12-20",
"check_out": "2021-12-24",
"unit_id": "27795",
"check_in": "2021-12-20",
"check_out": "2021-12-23",
"customer": {
"first_name": "Joe",
"last_name": "Schmoe",
"phone_number": "4445556666",
"email": ""
"external_id": "FakeReservation001"

business not found