Onboarding API Error Troubleshooting
Here is how-to guides to troubleshoot Onboarding API error
Property Route
321, Required field missing: ID
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
459, Invalid request code for CountryCode: XX
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:
497, Authorization error
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
9000, Internal Server Error
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.
9002, Input value(s) is not valid
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.
9007, HotelId: xxx already exists
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
9022, The request content was malformed
Error message: “The property request was malformed"
Solution: Channel manager must recheck the request or contact connectvitiy-tech-support@agoda.com for further investigation
9023, Invalid image url
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
9024, Unsupported type of image
Error message: “Unsupported type of image"
Solution: Channel manager must recheck the images and please provide image with jpeg, jpg, gif, png type only
9025, Authorization Failed: User does not have rights for Hotel id: xxx
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
9027, Duplicate hotel detected: %s
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.
9028, Invalid HotelName: First character must be English
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
9031, Hotel should have at least 3 images.
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
9032, User does not have rights for Chain id: xxxx
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
9042, CurrencyCode is not allowed to update. The property is created with CurrencyCode: 'xxx'.
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
9051, One main image is required for a hotel.
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
9053, TPA_Extensions: Directions should less than or equal to 50000 characters in total
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.
9087, Overall limit of %s requests per %s seconds for the user has been exceeded
Error message: “requests limit per second has been exceeded"
Solution: Please contact connectivity-tech-support@agoda.com to increase request limit
9094, 'Services' field with empty value cannot be allowed in the request
Error message: “'Services' field is missing from the request"
Solution: Services is mandatory field. Please recheck the request to include services and retry again
9201, Descriptions.DescriptiveText is required and cannot be empty
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
9202, Directions is required and cannot be empty
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
9203, GuestRoomInfo.Quantity is required and cannot be zero
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
9205, FeeCode: xxx, Amount: 0.0 should more than 0
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
9206, Duplicated FeeCode: xxx
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.
9209, Limit exceed for Property creation. Please contact your Agoda Partner services representative.
Error message: “Property limit exceed"
Solution: Please contact connectivity-tech-support@agoda.com to update property limit for your connection
9216, CountryCode %s is not allowed for Single Unit Property.
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
Room Route
205, Number of berths/beds invalid.
Error message: “SubRoom doesn't contain BedType"
Solution: Please recheck the request. All SubRoom requires at least 1 BedType.
321, Required field missing: %s.
Error message: “Required field is missing from the request"
Solution: Please recheck the request and the specification. Fields such as Descriptions is mandatory.
444, Restrictions - limit 1 room.
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.
459, Invalid request code for AmenityCode: %s.
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.
497, Authorization error
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
783, Room or rate not found
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.
851, Hotel with HotelCode %s was already deleted
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.
9000, Internal Server Error
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.
9002, The content of element is not complete, or invalid value in the request
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.
9011, RoomID: %s already exists
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.
9014, RoomID should not be defined in Overlay request
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.
9020, Description with en-US language is required
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.
9022, The request content was malformed
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
9023, Invalid image url:
Error message: “Invalid image url: "
Solution: Please recheck image url in the request again as it's invalid or missing
9024, Unsupported type of image: %s
Error message: “Image file type is not supported "
Solution: please provide image with jpeg, jpg, gif, png type
9025, Authorization Failed: User does not have rights for Hotel id: %s
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
9060, NumberOfBed: %s does not match with total number of BedRoom in SubRooms
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)
9078, For room: %s, MaximumRate must be greater than MinimumRate
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
9086, For room: %s, MaxChildrenInRoom must be between 0 and MaxOccupancy - 1
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
9087, Overall limit of %s requests per %s seconds for the user has been exceeded
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.
9209, Limit exceed for Room creation. Please contact your Agoda Partner services representative.
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.
Rate Plan Route
321, Required field missing: %s.
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.
459, Invalid request code for RatePlanCode: %s.
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.
497, Authorization error
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
9000, Internal Server Error
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
9002, The content of element is not complete, or invalid value in the request
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
9017, Rate Plan Id: %s already exists
Error message: RatePlanID in the request already existed in the property.
Solution: Please repush rate plan creation with a new RatePlanID
9022, The request content was malformed
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
9025, Authorization Failed: User does not have rights for Hotel id: %s
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
9035, Rate Plan with description: '%s' already exists
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
9042, RatePlanType is not allowed to update. The rate plan id: %s is created with RatePlanType: '%s'.
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.
9045, Home should have 1 rate plan.
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
9087, Overall limit of %s requests per %s seconds for the user has been exceeded
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.
9091, Hotel is not support sell channel code %s in RatePlan %s. Please add this channel to hotel via Managing Properties.
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
9209, Limit exceed for Rateplan creation. Please contact your Agoda Partner services representative.
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.
Product Route
459, Invalid request code for RatePlanCode: %s.
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.
497, Authorization error
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
9000, Internal Server Error
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
9002, The content of element is not complete, or invalid value in the request
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.
9025, Authorization Failed: User does not have rights for Hotel id: %s
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
9087, Overall limit of %s requests per %s seconds for the user has been exceeded
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.