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.