Post Booking - YellowStone

Creates a reservation from an online booking. The client must have Online Booking or Channel Manager
enabled; otherwise the request returns 200 but no reservation is created.

clientID must match the client the API key is issued for; a different client returns 403.

Sample request:

POST /api/Booking/PostBooking
{
"clientID": 1001,
"type": "RBS",
"bookingID": 100245,
"arrivalDate": "2026-10-15",
"departureDate": "2026-10-18",
"bookingParameters": { "reservationStatusID": 1, "reservationTypeID": 1, "isSendCorrespondence": false },
"primaryGuestDetails": { "firstName": "Jane", "lastName": "Doe", "email": "jane.doe@example.com", "phone": "5551234567" },
"guests": { "guestCount": 2, "adultCount": 2 },
"paymentDetails": { "paymentAmount": 250.00, "paymentSource": "Card", "paymentExtID": "txn_123" },
"roomsBooked": [ { "roomID": 12, "guestsInRoom": 2, "arrivalDate": "2026-10-15", "departureDate": "2026-10-18" } ]
}

Note: on success the request is echoed back in content. The booking is processed before the
response is returned, but a failure while creating the reservation is logged rather than returned,
so a 200 does not guarantee the reservation was created.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/json

Example

{
    "identity": "string",
    "clientID": 0,
    "type": "string",
    "action": "string",
    "bookingParameters": {
        "reservationStatusID": 0,
        "reservationTypeID": 0,
        "isSendCorrespondence": true,
        "correspondenceToBeSent": [
            {
                "correspondenceTypeID": 0
            }
        ]
    },
    "apiKey": "string",
    "bookingID": 0,
    "arrivalDate": "string",
    "departureDate": "string",
    "primaryGuestDetails": {
        "firstName": "string",
        "lastName": "string",
        "company": "string",
        "phone": "string",
        "email": "string",
        "address1": "string",
        "address2": "string",
        "state": "string",
        "city": "string",
        "zip": "string",
        "country": "string"
    },
    "paymentDetails": {
        "paymentAmount": 0,
        "paymentSource": "string",
        "paymentExtID": "string",
        "applyToCorrespondenceTypeID": 0,
        "surcharge": 0,
        "baseAmount": 0,
        "transactionTotal": 0,
        "paymentAdjustmentValue": 0
    },
    "guests": {
        "guestCount": 0,
        "adultCount": 0,
        "teenCount": 0,
        "youthCount": 0,
        "childCount": 0,
        "infantCount": 0
    },
    "cancellationFee": {
        "amount": 0
    },
    "roomsBooked": [
        {
            "roomID": 0,
            "guestsInRoom": 0,
            "arrivalDate": "string",
            "departureDate": "string",
            "rates": [
                {
                    "rateID": 0,
                    "unitCost": 0,
                    "quantity": 0,
                    "nights": 0,
                    "fromDate": "string",
                    "toDate": "string",
                    "isTaxOverride": true,
                    "taxAmount": 0
                }
            ],
            "roomNotes": [
                "string"
            ]
        }
    ],
    "activitiesBooked": [
        {
            "activityID": 0,
            "activityDate": "string",
            "participants": 0,
            "activityStartTime": "string",
            "activityEndTime": "string",
            "rates": [
                {
                    "rateID": 0,
                    "unitCost": 0,
                    "quantity": 0,
                    "nights": 0,
                    "isTaxOverride": true,
                    "taxAmount": 0
                }
            ],
            "activityNotes": [
                "string"
            ],
            "selectedHosts": [
                {
                    "employeeID": 0,
                    "employeeLastName": "string",
                    "employeeFirstName": "string"
                }
            ],
            "selectedLocations": [
                {
                    "locationID": 0,
                    "locationName": "string"
                }
            ],
            "selectedResources": [
                {
                    "resourceID": 0,
                    "resourceName": "string",
                    "resourceTypeID": 0
                }
            ]
        }
    ],
    "reservationSummaryNote": "string",
    "errorMessage": "string",
    "token": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.rbsapps.com/api/Booking/PostBooking' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "identity": "string",
    "clientID": 0,
    "type": "string",
    "action": "string",
    "bookingParameters": {
        "reservationStatusID": 0,
        "reservationTypeID": 0,
        "isSendCorrespondence": true,
        "correspondenceToBeSent": [
            {
                "correspondenceTypeID": 0
            }
        ]
    },
    "apiKey": "string",
    "bookingID": 0,
    "arrivalDate": "string",
    "departureDate": "string",
    "primaryGuestDetails": {
        "firstName": "string",
        "lastName": "string",
        "company": "string",
        "phone": "string",
        "email": "string",
        "address1": "string",
        "address2": "string",
        "state": "string",
        "city": "string",
        "zip": "string",
        "country": "string"
    },
    "paymentDetails": {
        "paymentAmount": 0,
        "paymentSource": "string",
        "paymentExtID": "string",
        "applyToCorrespondenceTypeID": 0,
        "surcharge": 0,
        "baseAmount": 0,
        "transactionTotal": 0,
        "paymentAdjustmentValue": 0
    },
    "guests": {
        "guestCount": 0,
        "adultCount": 0,
        "teenCount": 0,
        "youthCount": 0,
        "childCount": 0,
        "infantCount": 0
    },
    "cancellationFee": {
        "amount": 0
    },
    "roomsBooked": [
        {
            "roomID": 0,
            "guestsInRoom": 0,
            "arrivalDate": "string",
            "departureDate": "string",
            "rates": [
                {
                    "rateID": 0,
                    "unitCost": 0,
                    "quantity": 0,
                    "nights": 0,
                    "fromDate": "string",
                    "toDate": "string",
                    "isTaxOverride": true,
                    "taxAmount": 0
                }
            ],
            "roomNotes": [
                "string"
            ]
        }
    ],
    "activitiesBooked": [
        {
            "activityID": 0,
            "activityDate": "string",
            "participants": 0,
            "activityStartTime": "string",
            "activityEndTime": "string",
            "rates": [
                {
                    "rateID": 0,
                    "unitCost": 0,
                    "quantity": 0,
                    "nights": 0,
                    "isTaxOverride": true,
                    "taxAmount": 0
                }
            ],
            "activityNotes": [
                "string"
            ],
            "selectedHosts": [
                {
                    "employeeID": 0,
                    "employeeLastName": "string",
                    "employeeFirstName": "string"
                }
            ],
            "selectedLocations": [
                {
                    "locationID": 0,
                    "locationName": "string"
                }
            ],
            "selectedResources": [
                {
                    "resourceID": 0,
                    "resourceName": "string",
                    "resourceTypeID": 0
                }
            ]
        }
    ],
    "reservationSummaryNote": "string",
    "errorMessage": "string",
    "token": "string"
}'

Responses

🟢200

application/json

Booking received and processed

Bodyapplication/json

Example

{
    "content": {
        "identity": "string",
        "clientID": 0,
        "type": "string",
        "action": "string",
        "bookingParameters": {
            "reservationStatusID": 0,
            "reservationTypeID": 0,
            "isSendCorrespondence": true,
            "correspondenceToBeSent": [
                {
                    "correspondenceTypeID": 0
                }
            ]
        },
        "apiKey": "string",
        "bookingID": 0,
        "arrivalDate": "string",
        "departureDate": "string",
        "primaryGuestDetails": {
            "firstName": "string",
            "lastName": "string",
            "company": "string",
            "phone": "string",
            "email": "string",
            "address1": "string",
            "address2": "string",
            "state": "string",
            "city": "string",
            "zip": "string",
            "country": "string"
        },
        "paymentDetails": {
            "paymentAmount": 0,
            "paymentSource": "string",
            "paymentExtID": "string",
            "applyToCorrespondenceTypeID": 0,
            "surcharge": 0,
            "baseAmount": 0,
            "transactionTotal": 0,
            "paymentAdjustmentValue": 0
        },
        "guests": {
            "guestCount": 0,
            "adultCount": 0,
            "teenCount": 0,
            "youthCount": 0,
            "childCount": 0,
            "infantCount": 0
        },
        "cancellationFee": {
            "amount": 0
        },
        "roomsBooked": [
            {
                "roomID": 0,
                "guestsInRoom": 0,
                "arrivalDate": "string",
                "departureDate": "string",
                "rates": [
                    {
                        "rateID": 0,
                        "unitCost": 0,
                        "quantity": 0,
                        "nights": 0,
                        "fromDate": "string",
                        "toDate": "string",
                        "isTaxOverride": true,
                        "taxAmount": 0
                    }
                ],
                "roomNotes": [
                    "string"
                ]
            }
        ],
        "activitiesBooked": [
            {
                "activityID": 0,
                "activityDate": "string",
                "participants": 0,
                "activityStartTime": "string",
                "activityEndTime": "string",
                "rates": [
                    {
                        "rateID": 0,
                        "unitCost": 0,
                        "quantity": 0,
                        "nights": 0,
                        "isTaxOverride": true,
                        "taxAmount": 0
                    }
                ],
                "activityNotes": [
                    "string"
                ],
                "selectedHosts": [
                    {
                        "employeeID": 0,
                        "employeeLastName": "string",
                        "employeeFirstName": "string"
                    }
                ],
                "selectedLocations": [
                    {
                        "locationID": 0,
                        "locationName": "string"
                    }
                ],
                "selectedResources": [
                    {
                        "resourceID": 0,
                        "resourceName": "string",
                        "resourceTypeID": 0
                    }
                ]
            }
        ],
        "reservationSummaryNote": "string",
        "errorMessage": "string",
        "token": "string"
    },
    "errors": [
        {
            "code": "string",
            "description": "string"
        }
    ],
    "message": "string",
    "success": true
}

🟠401

🟠403

🔴500