The API allows Agoda connectivity partners to create new properties and update existing properties.
- It supports Hotel and Non-Hotel (Vacation rental) properties.
- It supports textual content in English only. Text in other languages is ignored. Content added in English is translated into multiple languages.
Field types
- Required: You must always send this field to make the property sellable.
- Optional:
- Unless otherwise specified, all fields are overwritten. Sending no value disables the function and can apply a default. For example, if you do not provide a particular Service in the request, Agoda assumes the service is not offered. If you do not provide MinLengthOfStay or MaxLengthOfStay, Agoda sets the default to
-1(no limit). - For fields marked (Overlay), sending no value does not update the field and retains the existing data. Examples include NumberOfBathroom and MaxChildrenInRoom.
- Unless otherwise specified, all fields are overwritten. Sending no value disables the function and can apply a default. For example, if you do not provide a particular Service in the request, Agoda assumes the service is not offered. If you do not provide MinLengthOfStay or MaxLengthOfStay, Agoda sets the default to
Contract Signing – Not Required for Supplier-Level Contracts
Note that Supplier-level contracts apply at the supplier/API-key level, rather than requiring a separate contract to be created and signed for every property (HID).
- If the contract configuration is at the Supplier level, the contract-signing flow is not required. Do not use the following paths:
- Get Contract
- Sign Contract
- Get Host Contracts
- Sign Host Contract
- You cannot create or update FeePolicies through the Content API. Please contact Accommodation Services Team at [email protected] for further support.
For RatePlan
In the Agoda system, the RatePlan description is combined with the RatePlanID provided by partners before saving.
- RatePlanID:
RP000001 - Description:
Special Rate - Description saved in the Agoda system:
(RP000001) Special Rate - Description returned when a partner retrieves it from the Agoda system:
(RP000001) Special Rate - Description to send when creating or updating:
Special Rate
Version information
Version: 1.0.15
URI scheme
- Host:
content-push.agoda.com - Base path:
/ - Schemes: HTTPS, HTTP
Tags
- CodeLists
- Contracts
- ErrorCodes
- Host Contracts
- HotelProducts
- Properties
- PropertyInfo
- PropertyOverallStatus
- PropertyStatus
- RatePlanStatus
- RatePlans
- RoomStatus
- Rooms