Introduction
Agoda is one of the OTA channels where you can manage the connection, perform room and rate plan mapping, import data from the OTA, and configure other settings through the following tabs: Information, Username, Mapping, Assignments, and Settings.
Agoda Information
The Agoda Information tab provides the basic connection procedure between the system and Agoda. Make sure you follow these steps:
Step | Description |
---|---|
1. Who can request connection? | Channel Manager or HOTEL itself |
2. Who must be contacted? | Agoda Connectivity Services: BD-Connectivity@agoda.com |
3. Which information is required to open connection? | Hotel ID from Agoda |
4. Extranet URL | https://ycs.agoda.com |
![]() |
Username
In the Username tab, you can enter or update the credentials required to connect to Agoda.
How to Update Username and Hotel Key
- Enter your Agoda Property ID in the Property ID field.
- Click the save (✓) button to apply the changes.
- If you don’t want to save the changes, click cancel (✖).
[!NOTE]
Troubleshooting Credential and Username Update
Failed to Save Property ID
- Make sure the Property ID is valid and correctly copied from Agoda.
- Check your internet connection and try again.
Changes Not Reflected After Saving
- Refresh the page to confirm if the changes have been applied.
- If not saved, re-enter the Property ID and click the save (✓) button again.
Mapping
The Mapping tab allows you to link each internal rate plan to the corresponding room and rate plan in Agoda. This enables the system to push rate, availability, and restriction data to the OTA.
How to Add Mapping
- On the Mapping tab, locate the Internal Rate Plan Name you want to map.
- Click Add Mapping next to the rate plan.
- A list of available room and rate plan combinations from Agoda will appear.
- Select one option that matches the room and rate plan you want to connect.
- Click Update to save the mapping.
- If you don’t want to continue, click Close to cancel the process.
NOTE: Mapping allows you to push rate, availability, and restrictions to Agoda once the mapping is complete.
Import Rooms
The Import Rooms feature helps you retrieve and display room and rate plan data from Agoda before doing any mapping.
How to Import Rooms from Agoda
- Click the Import Rooms button at the top of the Mapping tab. ![agoda][https://res.cloudinary.com/dayo5hqig/image/upload/v1747887354/03.mapping-_4_ifzb6h.jpg]
- A new page will display the room and rate plans available from Agoda.
- Review the list of rooms under the Room Name column.
- If you only want to push availability (without pricing), tick the Availability Only checkbox.
- If the checkbox is unticked, the system will push both rate and availability.
- Click Update Rateplans to complete the import. The data will be ready for mapping.
Assignments
The Assignments tab allows you to link child rate plans from Agoda to your internal rate plans for the purpose of receiving reservations. This function does not support pushing rate, availability, or restriction data — it is receive-only.
How to Assign Child Rate Plans
- On the Assignments tab, find the OTA Rate Plan Name you want to assign.
- Click Add Internal Rateplan next to the selected OTA rate plan.
- Select the matching internal rate plan from the dropdown.
- Click Save New Assignment to complete the assignment.
- To cancel the process, click the cancel (✖) button before saving.
- You can remove an assigned rate plan by clicking Remove This Ota Room.
NOTE: Use the assignment feature when Agoda provides child rate plans that you want to connect for reservation purposes only. These rate plans will not send updates for price or availability.
Settings
The Settings tab allows you to manage how the system interacts with Agoda, including enabling the channel, handling updates, and configuring reservation options.
How to Configure Settings
- Go to the Settings tab.
- Click Import Future Agoda Reservations to import the new reservations.
- Enable the Enable Channel option to activate the connection between your property and Agoda.
- Turn on Activate Updates to allow the system to push rate, availability, and restriction updates to Agoda.
- Enable Activate Reservations if you want to receive bookings from Agoda into the system.
- Enable Send Reservation Voucher Email if you want the system to email a voucher every time a booking is received.
- Enable Activate New OBP Model if you want to use Occupancy Based Pricing, where room rates vary based on the number of guests staying. ![agoda][https://res.cloudinary.com/dayo5hqig/image/upload/v1747887353/04.settings-_1_jbsbdu.jpg]
- In the Currency (if Different) field, click currency and select the currency code if your Agoda currency is different from your system’s default. If left blank, the system will detect the appropriate currency automatically.
- Click Update to save all changes.
How to Configure Manual OTA Update
- Scroll down to the OTA Update section.
- Select a specific room type from the dropdown menu, or choose All Room Types to push updates for all rooms.
- Click the OTA Update button to send the latest rate and availability data to Agoda.
Viewing Update History
At the bottom of the Settings tab, you will find the Last 10 Updates section.
This section shows details of the last ten updates sent to Agoda, including the update time, room type, rate plan, and the success/failure status of each update. Use this log to verify if the system is pushing data correctly to Agoda.