post
https://ari-dev.thehotelplanet.com/v1/push/hotels
Create or update hotel static data and supplier hotelId mapping. Maximum 500 hotels per request. Required before products and ARI.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Hotels list
POST /push/hotels
Create or update Nuitee Cloud properties and map each supplier hotelId to an internal property. Required before POST /push/products or POST /push/ari.
Runnable example: Quick start — Step 1
Try it (curl)
curl -sS -X POST "https://ari-dev.thehotelplanet.com/v1/push/hotels" \
-H "x-api-key: YOUR_SANDBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '[{"hotelId":"TEST001","hotelName":"Test Hotel","currency":"USD","isAvailable":true,"minChildAge":1,"maxChildAge":12}]'Request
JSON array of hotel objects. Maximum 500 hotels per request.
Required fields
| Field | Type | Description |
|---|---|---|
hotelId | string | Your property code |
hotelName | string | Display name |
currency | string | ISO currency (e.g. USD) |
isAvailable | boolean | Open for bookings |
minChildAge | integer | Min child age — must be greater than zero |
maxChildAge | integer | Max child age — must be greater than zero |
Commonly used optional fields
| Field | Description |
|---|---|
countryCodeISO2 | Two-letter country code |
city | City name — matched to reference data when possible |
email, chainCode, latitude, longitude, state, address, phone, timezone | Property details |
Example
[
{
"hotelId": "HOTEL_001",
"hotelName": "Demo Hotel Barcelona",
"currency": "EUR",
"isAvailable": true,
"minChildAge": 1,
"maxChildAge": 17,
"countryCodeISO2": "ES",
"city": "Barcelona",
"email": "[email protected]",
"address": ["Carrer Example 1"],
"phone": { "CountryAccessCode": "34", "phoneNumber": "931234567" },
"timezone": "Europe/Madrid"
}
]Success response
{ "code": "200", "message": "Hotels updated successfully" }Common errors
| Message | Cause | Fix |
|---|---|---|
Maximum 500 hotels can be updated at a time | Batch too large | Split requests |
Unauthorized API KEY | Invalid x-api-key | Check environment and key |
Validation on minChildAge or maxChildAge | Zero or missing | Use positive integers |
Notes
- Re-posting updates existing hotels (no separate idempotency key).
- Use this endpoint for new hotels and for changes to currency, availability, or contact/location data.
- Room and rate catalog belongs on Hotel rooms & rates, not here.