Here is how-to guides to troubleshoot Onboarding API error
Error message: “Property external ID is missing from the request"
Solution: Channel manager must revise the request to include external property ID so that property can be created on Agoda.com
Error message: “Country code provided is not correct"
Solution: Channel manager must revise the request to provide the correct country code
Example of incorrect request:
Error message: “Channel manager doesn't have content push API access to the property"
Solution: Channel manager must contact agoda.chain.support@agoda.com to assign CM_Content_API role to the property
Error message: “There is missing field in the request but there's no specific error message to recognize the error"
Solution: Channel manager must recheck the request or contact connectvitiy-tech-support@agoda.com for further investigation
Example of incorrect request: HouseRule is blank.
Error message: “There is an invalid value(s) in the request"
Solution: Channel manager must recheck the request or contact connectvitiy-tech-support@agoda.com for further investigation
Example of incorrect request: ChainCode is missing.
How to fix: Please provide ChainCode in the request. If the property doesn't have a specific ChainCode, please input '0' or completely remove ChianCode attribute from the request.
Error message: “The property already exist on Agoda"
Solution: Please recheck if there is a property with the same external ID and ChainID (if any) onboarded through your connection
Error message: “The property request was malformed"
Solution: Channel manager must recheck the request or contact connectvitiy-tech-support@agoda.com for further investigation
Error message: “Invalid image url"
Solution: Channel manager must recheck the image URL in the request or contact connectvitiy-tech-support@agoda.com for further investigation
Error message: “Unsupported type of image"
Solution: Channel manager must recheck the images and please provide image with jpeg, jpg, gif, png type only
Error message: “Channel manager doesn't have content push API access to the property"
Solution: Channel manager must contact agoda.chain.support@agoda.com to assign CM_Content_API role to the property
Error message: “The property already exist on Agoda"
Solution: Please contact connectvitiy-tech-support@agoda.com to check if there's a property exists with the same name and address.
Error message: “The property name's first character must be in English"
Solution: Please revise property name in the request as it must be in English, special characters and blank space is not allowed, and retry again
Error message: “Hotel should have at least 3 images as it's a minimum requirement"
Solution: Please provide at least 3 images in the request and retry again
Error message: “Channel manager doesn't have a right to ChainCode provided in the request"
Solution: Please contact connectivity-tech-support@agoda.com to set up ChainCode for your connection
Error message: “Incorrect currency provided in the request. Overlay request must has the same currency code property was created with"
Solution: Please revise currency code in the request and retry again
Error message: “One main image is required for a hotel."
Solution: Please provide at least 3 images in the request, assign one of them as main image, and retry again
Error message: “Directions in the request exceeds 50000 characters limit"
Solution: Please revise directions in the request to have not more than 50000 characters in total.
Error message: “requests limit per second has been exceeded"
Solution: Please contact connectivity-tech-support@agoda.com to increase request limit
Error message: “'Services' field is missing from the request"
Solution: Services is mandatory field. Please recheck the request to include services and retry again
Error message: “'Property description is missing from the request"
Solution: Descriptions.DescriptiveText is mandatory field. Please recheck the request to include description and retry again
Error message: “'Direction field is missing from the request for non-hotel accommodation property"
Solution: Direction is mandatory field for vacation rental properties. Please recheck the request to include Direction and retry again
Error message: “GuestRoomInfo.Quantity is a mandatory field and cannot be zero"
Solution: GuestRoomInfo.Quantity is mandatory field and cannot be zero Please recheck the request to include GuestRoomInfo.Quantity or update value instead of 0 to an actual quantity and retry again
Error message: “Fee value cannot be zero"
Solution: Please recheck the request and update fee value. If there's no actual fee, please remove fee attribute from the request
Error message: “Duplicate fee type"
Solution: Please recheck the request and update fee code. Please contact connectivity-tech-support@agoda.com for further investigation if you require further support or have further questions.
Error message: “Property limit exceed"
Solution: Please contact connectivity-tech-support@agoda.com to update property limit for your connection
Error message: “vacation rental properties are not yet allowed for this country"
Solution: For certain countries, vacation rental properties are not yet allowed on Agoda. Please contact connectivity-tech-support@agoda.com for further questions
Error message: “SubRoom doesn't contain BedType"
Solution: Please recheck the request. All SubRoom requires at least 1 BedType.
Error message: “Required field is missing from the request"
Solution: Please recheck the request and the specification. Fields such as Descriptions is mandatory.
Error message: “There's 1 room limit for non-hotel accommodation property"
Solution: Please recheck the overall data again. For vacation rental properties, only 1 room can be created. If channel manager has only pushed 1 room to Agoda, please contact connectivity-tech-support@agoda.com for further investigation.
Error message: “AmenityCode is invalid"
Solution: Please recheck the AmenityCode in the request. If further info required, please contact connectivity-tech-support@agoda.com for further support.
Error message: “Channel manager doesn't have content push API access to the property"
Solution: Channel manager must contact agoda.chain.support@agoda.com to assign CM_Content_API role to the property
Error message: “Room type ID does not exist or has been deleted on Agoda"
Solution: Please recheck room type ID in the request. If further info required, please contact connectivity-tech-support@agoda.com for further support.
Error message: “Property has already been deleted so room cannot be updated"
Solution: Please recheck the property status in your system as property has already been deleted on Agoda. Deleted properties cannot be activated back so if property is supposed to be live and active, please repush property as a newly created property again.
Error message: “There is missing field or incorrect value input in the request but there's no specific error message to recognize the error"
Solution: Channel manager must recheck the request or contact connectvitiy-tech-support@agoda.com for further investigation
Example of incorrect request: Value should not be = 0.
Error message: “There is missing or invalid value in the request"
Solution: Please recheck request message and repush again. If further info required, please contact connectivity-tech-support@agoda.com for further support.
Please see below example. HotelCode is blank while ID is not required.
Error message: “RoomID is already created and existed"
Solution: Please recheck RoomID in the request message again. If the same RoomID has already been pushed to Agoda, please use a new roomID to create a new room type.
Error message: “RoomID should not be defined in Overlay request"
Solution: Please recheck RoomID in the request message again. If you would like to update room information of an existing room, please use Agoda InvCode in an overlay request.
Error message: “Description with en-US language is required"
Solution: Please recheck room push request again as description is missing from the request.
Below is an example of a request that got an error due to description is missing.
Error message: “The request content was malformed"
Solution: Please recheck room push request again as the request was malformed
Below is an example of a request that got an error due to special characters such as '&', '()' included in description
Error message: “Invalid image url: "
Solution: Please recheck image url in the request again as it's invalid or missing
Error message: “Image file type is not supported "
Solution: please provide image with jpeg, jpg, gif, png type
Error message: “Channel manager doesn't have content push API access to the property"
Solution: Channel manager must contact agoda.chain.support@agoda.com to assign CM_Content_API role to the property
Error message: Number of beds included in the request does not match number of BedRoom in SubRooms
Solution: Please recheck the request and update accordingly
Below is an example of mismatch number of beds (3) vs. number of BedRoom in SubRooms (4)
Error message: MaximumRate must be greater than MinimumRate
Solution: Please recheck the request and update accordingly
Below is an example of MaximumRate lower than or equal to MinimumRate
Error message: MaxChildrenInRoom must be between 0 and MaxOccupancy number - 1
Solution: Please recheck the request and update accordingly. MaxChildrenInRoom must be between 0 and any value less than MaxOccupancy
Below is an example of MaxChildrenInRoom equal to MaxOccupancy
Error message: Number of requests pushed per second exceed limit in the configuration
Solution: Please either decrease number of requests per second or contact connectivity-tech-support@agoda.com to adjust the configuration.
Error message: Number of rooms created in a property exceed limit in the configuration
Solution: Please contact connectivity-tech-support@agoda.com to adjust the configuration.
Error message: “Required field is missing from the request"
Solution: Please recheck the request and the specification. Fields such as RatePlanCode, Descriptions is mandatory.
Below is an example of a request which RatePlanCode is missing.
Error message: “RatePlanCode is invalid"
Solution: Please recheck the RatePlanCode in the request. If further info required, please contact connectivity-tech-support@agoda.com for further support.
Error message: “Channel manager doesn't have content push API access to the property"
Solution: Channel manager must contact agoda.chain.support@agoda.com to assign CM_Content_API role to the property
Error message: “There is missing field or incorrect value input in the request but there's no specific error message to recognize the error"
Solution: Channel manager must recheck the request or contact connectvitiy-tech-support@agoda.com for further investigation
Error message: “There is missing or invalid value in the request"
Solution: Please recheck request message and repush again. If further info required, please contact connectivity-tech-support@agoda.com for further support.
Please see below example. RatePlanNotifType, RatePlanID (for new rate plan creation), and Description Name are not included in the request
Error message: RatePlanID in the request already existed in the property.
Solution: Please repush rate plan creation with a new RatePlanID
Error message: “The request content was malformed"
Solution: Please recheck rate plan push request again as the request was malformed
Below is an example of a request that got an error due to special characters such as '&', '()' included in description
Error message: “Channel manager doesn't have content push API access to the property"
Solution: Channel manager must contact agoda.chain.support@agoda.com to assign CM_Content_API role to the property
Error message: Rate Plan description AKA rate plan name in the request is duplicated with existing rate plan name
Solution: Please change the rate plan name in the request and retry again
Error message: RatePlanType cannot be updated via API
Solution: Please kindly remove RatePlanType from the request or align RatePlanType with property set up. If you'd like to change RatePlanType, please contact agoda.chain.support@agoda.com for further assistance.
Error message: Non-Hotel Accommodation should have one rate plan only
Solution: Please kindly delete existing rate plan to be able to create a new one or update <GuestRoomInfo Quantity="1"></GuestRoomInfo> in property request to be more than one so that you can create more than one rate plan
Error message: Number of requests pushed per second exceed limit in the configuration
Solution: Please either decrease number of requests per second or contact connectivity-tech-support@agoda.com to adjust the configuration.
Error message: Channel Code included in rate plan request is not activated at property level
Solution: Please repush OVERLAY or DELTA for property push request to include channel ID or contact agoda.chain.support@agoda.com to activate the perferred channel
Error message: Number of Rateplan created in a property exceed limit in the configuration
Solution: Please contact connectivity-tech-support@agoda.com to adjust the configuration.
Error message: “RatePlanCode is invalid"
Solution: Please recheck the RatePlanCode in the request. It's either invalid (rate plan code doesn't exist in this property) or our system is still processing the newly created rate plan (retry will help resolve the issue). If further info required, please contact connectivity-tech-support@agoda.com for further support.
Error message: “Channel manager doesn't have content push API access to the property"
Solution: Channel manager must contact agoda.chain.support@agoda.com to assign CM_Content_API role to the property
Error message: “There is missing field or incorrect value input in the request but there's no specific error message to recognize the error"
Solution: Channel manager must recheck the request or contact connectvitiy-tech-support@agoda.com for further investigation
Error message: “There is missing or invalid value in the request"
Solution: Please recheck request message and repush again. If further info required, please contact connectivity-tech-support@agoda.com for further support.
Please see below example. RatePlanCode is not included in the request. The purpose of Product mapping is to map rate plan and room type together.
Error message: “Channel manager doesn't have content push API access to the property"
Solution: Channel manager must contact agoda.chain.support@agoda.com to assign CM_Content_API role to the property
Error message: Number of requests pushed per second exceed limit in the configuration
Solution: Please either decrease number of requests per second or contact connectivity-tech-support@agoda.com to adjust the configuration.