# Turn Agoda YCS into an API > Build methods that return your YCS reservations, bookings ready for payout and past payouts as JSON, one API call each. Then have a workflow check the Amended and Cancelled tabs for every property each morning and email you the changes. Page: https://fous.com/automate/agoda-ycs Updated: 2026-11-12 Works with your own Agoda YCS account. Fous is an independent product. ## What you can build on YCS ### Get reservations Reads Bookings >> Reservations for one property and stay dates, on the All, Confirmed, Amended or Cancelled tab, and opens each booking for its details. - Takes: Property, stay dates, tab (optional) - Returns: Booking ID, status, guest name, stay dates, room type, rate plan, payment model ### Get bookings ready for payout Reads Finance > Payouts for one property: the bookings listed under Bookings ready for payout and the entries in the Adjustments section. - Takes: Property - Returns: Booking ID, amount, adjustments ### Get past payouts Reads Finance > Past payouts for one property: each payout batch with its bookings, amount and Value Date. - Takes: Property, since date (optional) - Returns: Payout batch, Value Date, bookings, amount ### Update availability and rates on the Calendar Opens Rates and availability >> Calendar, sets Availability per day for a room type and the rate for a rate plan on the dates you give, then saves. - Takes: Property, room type, rate plan, dates, availability per day, rate - Returns: Room type, rate plan, dates, availability per day, rate, saved ## Automate YCS with a workflow A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use. ### Amended and cancelled reservations, every property Starts: Every day at 7:00 1. For each property you name, get the reservations on the Amended and Cancelled tabs for stays in the next 30 days. 2. Keep the bookings that were not on those tabs on the last run. 3. Email you the list, one section per property. ### Bookings ready for payout, for finance to confirm Starts: Every Monday at 8:00 1. For each property, get the bookings listed under Bookings ready for payout and the Adjustments. 2. Stop when no property has a booking ready. 3. Email you each property's bookings and adjustments, so someone confirms the payout in YCS. ### Past payouts, posted to your accounting system Starts: Every weekday at 9:00 1. For each property, get the past payouts. 2. Keep the payout batches that were not there on the last run. 3. Post each batch, with its Value Date, Booking IDs and amount, to your accounting webhook. You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month. ## Once built, one call from your code Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get reservations” would look like. Example request: ``` curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "method": "ycs.agoda.com/get_reservations", "input": { "property": "Northwind Riverside Hotel", "stay_from": "2026-11-20", "stay_to": "2026-11-30", "tab": "Amended" } }' ``` Example response: ``` { "status": "completed", "data": { "property": "Northwind Riverside Hotel", "tab": "Amended", "reservations": [ { "booking_id": "880214537", "status": "Amended", "guest_name": "Dana Whitfield", "check_in": "2026-11-22", "check_out": "2026-11-25", "room_type": "Deluxe Double", "rate_plan": "Breakfast included", "payment_model": "Agoda Collect (PREPAID)" } ], "count": 1 } } ``` An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request. ## YCS’s own options Agoda documents the YCS API (Agoda Connectivity API) for rates, availability, restrictions, products and bookings. Agoda says it can be used by properties connected through a channel manager; existing partners ask their Account Manager or the connectivity support team. A property without one works in YCS itself, where the reservation list downloads as CSV. | Option | What it covers | What it takes | | --- | --- | --- | | YCS API (Agoda Connectivity API) | Updates availability, rates, inventory and restrictions, updates product settings, and retrieves the booking list and booking details. | A connection through a channel manager. Existing partners contact their Account Manager or Agoda Connectivity support. | | YCS by hand | Bookings >> Reservations with a Download (.csv) button, the Calendar, Promotions and the Finance pages, one property at a time. | A YCS username linked to each property. | Read on November 12, 2026: [Agoda supply API introduction](https://developer.agoda.com/supply/docs/introduction), [How do I use Partner Portal?](https://partnerhub.agoda.com/how-do-i-use-yield-control-system-ycs/), [Tracking Agoda Special Offers bookings in Reservations](https://www.partnerhub.agoda.com/?p=95069). ## Signing in to YCS YCS, which Agoda's help also calls the Partner Portal, asks for your email and password. The first sign-in sends a sign-in link by email, a newly linked username gets a PIN by email or the app, and a session ends after 6 hours idle. With Fous you sign in once through YCS's own sign-in: the login is sealed with AES-256, emailed links and codes are handled, and an expired session is signed back in. ## Worth knowing - **Channel manager properties update elsewhere**: Agoda's help says a property connected to a channel manager updates its price and availability in that system, not in the Calendar. A Calendar method fits a property that manages YCS by hand. - **Payouts are not automatic**: Bank transfer bookings become payable 30 days after departure, each payout is confirmed by hand with Get Payout and Confirm, and funds arrive in 3 to 5 business days. - **Finance depends on how Agoda pays you**: The Finance tab appears only for properties paid by Telex Transfer, e-Card or UPC on ePass. A property on another arrangement has no payout pages to read. - **One property at a time**: A user with several properties picks one under Listings before Reservations, the Calendar or Finance show anything, so a method takes the property as an input. ## More in Travel and hospitality - [IATA BSPlink](https://fous.com/automate/iata-bsplink.md) - [My ARC](https://fous.com/automate/my-arc.md) - [Amadeus Selling Platform Connect](https://fous.com/automate/amadeus-selling-platform-connect.md) - [Travelport Smartpoint](https://fous.com/automate/travelport-smartpoint.md) - [Alloggiati Web](https://fous.com/automate/alloggiati-web.md) - [SES.Hospedajes](https://fous.com/automate/ses-hospedajes.md) - [Cvent Supplier Network](https://fous.com/automate/cvent-supplier-network.md) - [Booking.com Extranet](https://fous.com/automate/booking-com-extranet.md) - [Expedia Partner Central](https://fous.com/automate/expedia-partner-central.md) - [Trip.com eBooking](https://fous.com/automate/trip-com-ebooking.md) - [Tripadvisor Management Centre](https://fous.com/automate/tripadvisor-management-centre.md) - [Airbnb hosting dashboard](https://fous.com/automate/airbnb-hosting-dashboard.md) - [GetYourGuide Supplier Portal](https://fous.com/automate/getyourguide-supplier-portal.md) - [Viator Supplier Center](https://fous.com/automate/viator-supplier-center.md) Other industries: [AFPnet](/automate/afpnet), [KRA iTax](/automate/kra-itax), [e-Zamówienia](/automate/e-zamowienia), [ePortal ESTV](/automate/eportal-estv), [The Compliance Engine](/automate/the-compliance-engine), [ApplyOnline](/automate/applyonline). ## Frequently asked questions ### Does Agoda YCS have an API? Yes, through a channel manager. Agoda's YCS API updates rates, availability and restrictions and retrieves bookings, and Agoda says it can be used by properties connected via channel managers. A property without one works in YCS itself, where reservations download as CSV. ### How do I download my Agoda bookings? Open Bookings >> Reservations, set the stay dates and filters, click Apply and use Download (.csv). The All, Confirmed, Amended and Cancelled tabs narrow the list. With Fous, a method returns the same reservations as JSON and a workflow can collect them for every property. ### When can I collect payment for bank transfer bookings? 30 days after the guest's departure date, under Finance > Payouts. Bookings ready for payout are selected by default, you click Get Payout, check the summary and Confirm. Funds arrive in 3 to 5 business days, and Past payouts shows the Value Date. ### Can I change rates in YCS if I use a channel manager? Agoda's help says to update price and availability in your channel manager's system instead. The Calendar in YCS is where properties without a connection set Availability per day and rates per rate plan. ### Is Fous affiliated with Agoda? No. Fous is an independent product. You use it with your own YCS account, and a method reads and does only what that account can. Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Agoda YCS (Agoda). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.