Error Codes

Endpoints
Error Code
Error Message
Error Description
Solution
Remarks
Property Route321Required field missing: IDProperty external ID is missing from the requestChannel manager must revise the request to include external property ID so that property can be created on Agoda.com
Property Route459Invalid request code for CountryCode: XXCountry code provided is not correctChannel manager must revise the request to provide the correct country codeExample of incorrect request
Example of incorrect request:
Property Route/Room Route/Rate Plan Route497Authorization ErrorChannel manager doesn't have content push API access to the propertyChannel manager must contact [email protected] to assign permission role to the property
Property Route/Room Route/Rate Plan Route9000Internal Server ErrorThere is missing field in the request but there's no specific error message to recognize the errorChannel manager must recheck the request or contact Connectivity Support Team via Technical Support FormExample of incorrect request: HouseRule is blank
Example of incorrect request:
Property Route/Room Route/Rate Plan Route9002Input value(s) is not validThere is a missing or an invalid value(s) in the requestChannel manager must recheck the request or contact Connectivity Support Team via Technical Support FormExample of incorrect request: ChainCode is missing.
Example of incorrect request:
Property Route9007HotelId: xxx already existsThe property already exist on AgodaPlease recheck if there is a property with the same external ID and ChainID (if any) onboarded through your connection
Property Route/Room Route/Rate Plan Route9022The request content was malformedThe property request was malformedChannel manager must recheck the request or contact Connectivity Support Team via Technical Support Form
Property Route/Room Route9023Invalid image urlInvalid image urlChannel manager must recheck the request or contact Connectivity Support Team via Technical Support Form
Property Route/Room Route9024Unsupported type of imageUnsupported type of imageChannel manager must recheck the images and please provide image with jpeg, jpg, gif, png type only
Property Route/Room Route/Rate Plan Route9025Authorization Failed: User does not have rights for Hotel id: xxxChannel manager doesn't have content push API access to the propertyChannel manager must contact [email protected] to assign permission role to the property
Property Route9027Duplicate hotel detected: %sThe property already exist on AgodaPlease contact Connectivity Support Team via Technical Support Form to check if there's a property exists with the same name and address.
Property Route9028Invalid HotelName: First character must be EnglishThe property name's first character must be in EnglishPlease revise property name in the request as it must be in English, special characters and blank space is not allowed, and retry again
Property Route9031Hotel should have at least 3 images.Hotel should have at least 3 images as it's a minimum requirementPlease provide at least 3 images in the request and retry again
Property Route9032User does not have rights for Chain id: xxxxChannel manager doesn't have a right to ChainCode provided in the requestPlease contact Connectivity Support Team via Technical Support Form to set up ChainCode for your connection.
Property Route9042CurrencyCode is not allowed to update. The property is created with CurrencyCode: 'xxx'.Incorrect currency provided in the request. Overlay request must has the same currency code property was created withPlease revise currency code in the request and retry again
Property Route9051One main image is required for a hotel.One main image is required for a hotel.Please provide at least 3 images in the request, assign one of them as main image, and retry again
Property Route9053TPA_Extensions: Directions should less than or equal to 50000 characters in totalDirections in the request exceeds 50000 characters limitPlease revise directions in the request to have not more than 50000 characters in total.
Property Route/Room Route/Rateplan Route9087Overall limit of %s requests per %s seconds for the user has been exceededRequests limit per second has been exceededPlease contact Connectivity Support Team via Technical Support Form to increase request limit.
Property Route9094'Services' field with empty value cannot be allowed in the requestServices' field is missing from the requestServices is mandatory field. Please recheck the request to include services and retry again.
Property Route9201Descriptions.DescriptiveText is required and cannot be emptyProperty description is missing from the requestDescriptions.DescriptiveText is mandatory field. Please recheck the request to include description and retry again.
Property Route9202Directions is required and cannot be emptyDirection field is missing from the request for non-hotel accommodation propertyDirection is mandatory field for vacation rental properties. Please recheck the request to include Direction and retry again.
Property Route9203GuestRoomInfo.Quantity is required and cannot be zeroGuestRoomInfo.Quantity is a mandatory field and cannot be zeroGuestRoomInfo.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.
Property Route9205FeeCode: xxx, Amount: 0.0 should more than 0Fee value cannot be zeroPlease recheck the request and update fee value. If there's no actual fee, please remove fee attribute from the request.
Property Route9206Duplicated FeeCode: xxxDuplicate fee typePlease recheck the request and update fee code. Please contact Connectivity Support Team via Technical Support Form for further investigation if you require further support or have further questions.
Property Route/Room Route/Rate Plan Route9209Limit exceed for Property creation. Please contact your Agoda Partner services representativeProperty limit exceedPlease contact Connectivity Support Team via Technical Support Form to update property limit for your connection.
Property Route9216CountryCode %s is not allowed for Single Unit Property.Vacation rental properties are not yet allowed for this countryFor certain countries, vacation rental properties are not yet allowed on Agoda. Please contact Connectivity Support Team via Technical Support Form for further questions.
Room Route205Number of berths/beds invalid.SubRoom doesn't contain BedTypePlease recheck the request. All SubRoom requires at least 1 BedType..
Room Route321Required field missing: %s.Required field is missing from the requestPlease recheck the request and the Specification. Fields such as Descriptions is mandatory.
Room Route444Restrictions - limit 1 roomThere's 1 room limit for non-hotel accommodation propertyPlease 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 Support Team via Technical Support Form for further investigation.
Room Route459Invalid request code for AmenityCode: %s.AmenityCode is invalidPlease recheck the AmenityCode in the request. If further info required, please contact Connectivity Support Team via Technical Support Form for further support.
Room Route783Room or rate not foundRoom type ID does not exist or has been deleted on AgodaPlease recheck room type ID in the request. If further info required, please contact Connectivity Support Team via Technical Support Form for further support.
Room Route851Hotel with HotelCode %s was already deletedProperty has already been deleted so room cannot be updatedPlease 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.
Room Route9011RoomID: %s already existsRoomID is already created and existedPlease 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.
Room Route9014RoomID should not be defined in Overlay requestRoomID should not be defined in Overlay requestPlease 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.
Room Route9020Description with en-US language is requiredDescription with en-US language is requiredPlease 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.
Example of request:
Room Route9060NumberOfBed: %s does not match with total number of BedRoom in SubRoomsNumber of beds included in the request does not match number of BedRoom in SubRoomsPlease recheck the request and update accordingly.Below is an example of mismatch number of beds (3) vs. number of BedRoom in SubRooms (4).
Example of request
Room Route9078For room: %s, MaximumRate must be greater than MinimumRateMaximumRate must be greater than MinimumRatePlease recheck the request and update accordingly.Below is an example of MaximumRate lower than or equal to MinimumRate.
Example of request
Room Route9086For room: %s, MaxChildrenInRoom must be between 0 and MaxOccupancy - 1MaxChildrenInRoom must be between 0 and MaxOccupancy number - 1Please 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.
Example of request
Room Route9209Limit exceed for Room creation. Please contact your Agoda Partner services representativeNumber of rooms created in a property exceed limit in the configurationPlease contact Connectivity Support Team via Technical Support Form to adjust the configuration.
Rateplan Route321Required field missing: %s.Required field is missing from the requestPlease recheck the request and the specification. Fields such as RatePlanCode, Descriptions is mandatory.
Rateplan Route459Invalid request code for RatePlanCode: %s.RatePlanCode is invalidPlease recheck the RatePlanCode in the request. If further info required, please contact Connectivity Support Team via Technical Support Form for further support.Below is an example request.
Example of request
Rateplan Route9017Rate Plan Id: %s already existsRatePlanID in the request already existed in the property.Please repush rate plan creation with a new RatePlanID.
Rateplan Route9035Rate Plan with description: '%s' already existsRate Plan description AKA rate plan name in the request is duplicated with existing rate plan namePlease change the rate plan name in the request and retry again.
Rateplan Route9042RatePlanType is not allowed to update. The rate plan id: %s is created with RatePlanType: '%s'.RatePlanType cannot be updated via APIPlease kindly remove RatePlanType from the request or align RatePlanType with property set up. If you'd like to change RatePlanType, please contact [email protected] for further assistance.
Rateplan Route9045Home should have 1 rate plan.Non-Hotel Accommodation should have one rate plan onlyPlease kindly delete existing rate plan to be able to create a new one or update GuestRoomInfo Quantity="1" in property request to be more than one so that you can create more than one rate plan.
Rateplan Route9091Hotel is not support sell channel code %s in RatePlan %s. Please add this channel to hotel via Managing Properties.Channel Code included in rate plan request is not activated at property levelPlease repush OVERLAY or DELTA for property push request to include channel ID or contact [email protected] to activate the perferred channel.
Rateplan Route9091Hotel is not support sell channel code %s in RatePlan %s. Please add this channel to hotel via Managing Properties.Channel Code included in rate plan request is not activated at property levelPlease repush OVERLAY or DELTA for property push request to include channel ID or contact [email protected] to activate the perferred channel.
Rateplan Route9209Limit exceed for Rateplan creation. Please contact your Agoda Partner services representativeNumber of Rateplan created in a property exceed limit in the configurationPlease contact Connectivity Support Team via Technical Support Form to adjust the configuration.