Error Codes
Please refer to this page for Content Push API Error Codes and Troubleshooting Guide.
Property Route Errors
Room Route Errors
Rate Plan Route Errors
Property Route Errors
| Error Code | Error Message | Error Description | Solution | Remarks |
|---|---|---|---|---|
| 321 | Required field missing: ID | Property external ID is missing from the request | 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 | Country code provided is not correct | Channel manager must revise the request to provide the correct country code | Example of incorrect request  |
| 497 | Authorization Error | Channel manager doesn't have content push API access to the property | Channel manager must contact [email protected] to assign permission role to the property | |
| 9000 | Internal Server Error | There is missing field in the request but there's no specific error message to recognize the error | Channel manager must recheck the request or contact Connectivity Support Team via Technical Support Form | Example of incorrect request: HouseRule is blank  |
| 9002 | Input value(s) is not valid | There is a missing or an invalid value(s) in the request | Channel manager must recheck the request or contact Connectivity Support Team via Technical Support Form | Example of incorrect request: ChainCode is missing. |
| 9007 | HotelId: xxx already exists | The property already exist on Agoda | 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 | The property request was malformed | Channel manager must recheck the request or contact Connectivity Support Team via Technical Support Form | |
| 9023 | Invalid image url | Invalid image url | Channel manager must recheck the request or contact Connectivity Support Team via Technical Support Form | |
| 9024 | Unsupported type of image | Unsupported type of image | Channel manager must recheck the images and provide image with jpeg, jpg, gif, png type only | |
| 9025 | Authorization Failed: User does not have rights for Hotel id: xxx | Channel manager doesn't have content push API access to the property | Channel manager must contact [email protected] to assign permission role to the property | |
| 9027 | Duplicate hotel detected: %s | The property already exist on Agoda | Please contact Connectivity Support Team via Technical Support Form to check if there's a property exists with the same name and address. | |
| 9028 | Invalid HotelName: First character must be English | The property name's first character must be in English | 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. | Hotel should have at least 3 images as it's a minimum requirement | Please provide at least 3 images in the request and retry again | |
| 9032 | User does not have rights for Chain id: xxxx | Channel manager doesn't have a right to ChainCode provided in the request | Please contact Connectivity Support Team via Technical Support Form to set up ChainCode for your connection. | |
| 9042 | CurrencyCode 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 with | Please revise currency code in the request and retry again | |
| 9051 | One 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 | |
| 9053 | TPA_Extensions: Directions should less than or equal to 50000 characters in total | Directions in the request exceeds 50000 characters limit | 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 | Requests limit per second has been exceeded | Please contact Connectivity Support Team via Technical Support Form to increase request limit. | |
| 9094 | 'Services' field with empty value cannot be allowed in the request | Services' field is missing from the request | Services is mandatory field. Please recheck the request to include services and retry again. | |
| 9201 | Descriptions.DescriptiveText is required and cannot be empty | Property description is missing from the request | Descriptions.DescriptiveText is mandatory field. Please recheck the request to include description and retry again. | |
| 9202 | Directions is required and cannot be empty | Direction field is missing from the request for non-hotel accommodation property | 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 | GuestRoomInfo.Quantity is a mandatory field and cannot be zero | 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 | Fee value cannot be zero | 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 | Duplicate fee type | Please 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. | |
| 9209 | Limit exceed for Property creation. Please contact your Agoda Partner services representative | Property limit exceed | Please contact Connectivity Support Team via Technical Support Form to update property limit for your connection. | |
| 9216 | CountryCode %s is not allowed for Single Unit Property. | Vacation rental properties are not yet allowed for this country | For certain countries, vacation rental properties are not yet allowed on Agoda. For list of countries that not allowed, please refer here or contact Connectivity Support Team via Technical Support Form for further questions. |
Room Route Errors
| Error Code | Error Message | Error Description | Solution | Remarks |
|---|---|---|---|---|
| 205 | Number of berths/beds invalid. | SubRoom doesn't contain BedType | Please recheck the request. All SubRoom requires at least 1 BedType. | |
| 321 | Required field missing: %s. | Required field is missing from the request | Please recheck the request and the Specification. Fields such as Descriptions is mandatory. | |
| 444 | Restrictions - limit 1 room | There's 1 room limit for non-hotel accommodation property | 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 Support Team via Technical Support Form for further investigation. | |
| 459 | Invalid request code for AmenityCode: %s. | AmenityCode is invalid | Please recheck the AmenityCode in the request. If further info required, please contact Connectivity Support Team via Technical Support Form for further support. | |
| 783 | Room or rate not found | Room type ID does not exist or has been deleted on Agoda | Please recheck room type ID in the request. If further info required, please contact Connectivity Support Team via Technical Support Form for further support. | |
| 851 | Hotel with HotelCode %s was already deleted | Property has already been deleted so room cannot be updated | 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. | |
| 9011 | RoomID: %s already exists | RoomID is already created and existed | 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 | RoomID should not be defined in Overlay request | 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 | Description with en-US language is required | 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.  |
| 9060 | NumberOfBed: %s does not match with total number of BedRoom in SubRooms | Number of beds included in the request does not match number of BedRoom in SubRooms | 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 | MaximumRate must be greater than MinimumRate | 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 | MaxChildrenInRoom must be between 0 and MaxOccupancy number - 1 | 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.  |
| 9209 | Limit exceed for Room creation. Please contact your Agoda Partner services representative | Number of rooms created in a property exceed limit in the configuration | Please contact Connectivity Support Team via Technical Support Form to adjust the configuration. |
Rate Plan Route Errors
| Error Code | Error Message | Error Description | Solution | Remarks |
|---|---|---|---|---|
| 321 | Required field missing: %s. | Required field is missing from the request | Please recheck the request and the specification. Fields such as RatePlanCode, Descriptions is mandatory. | |
| 459 | Invalid request code for RatePlanCode: %s. | RatePlanCode is invalid | Please 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.  |
| 9017 | Rate Plan Id: %s already exists | RatePlanID in the request already existed in the property. | Please repush rate plan creation with a new RatePlanID. | |
| 9035 | Rate Plan with description: '%s' already exists | Rate Plan description AKA rate plan name in the request is duplicated with existing rate plan name | 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'. | RatePlanType cannot be updated via API | Please 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. | |
| 9045 | Home should have 1 rate plan. | Non-Hotel Accommodation should have one rate plan only | Please 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. | |
| 9091 | Hotel 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 level | Please repush OVERLAY or DELTA for property push request to include channel ID or contact [email protected] to activate the preferred channel. | |
| 9209 | Limit exceed for Rateplan creation. Please contact your Agoda Partner services representative | Number of Rateplan created in a property exceed limit in the configuration | Please contact Connectivity Support Team via Technical Support Form to adjust the configuration. |
Updated 10 days ago