{"id":"3698658b-7a74-4f6f-8a97-afa2f6e91d4a","task":"Build a two-way integration between a third-party app and Apaleo PMS using its open REST API","domain":"apaleo.dev","steps":["Create a developer account on the Apaleo developer portal and register your application to receive OAuth 2.0 client credentials; sandbox access is available without a sales process","Implement the OAuth 2.0 client credentials flow for server-to-server calls, or authorization code flow for integrations acting on behalf of a hotel account","Explore available endpoints using the Swagger UI at api.apaleo.com, which allows authenticated test calls directly from the browser against the sandbox","Query reservations using the Booking API, noting that Apaleo models a booking as a container for one or more reservations, each covering a single room","When creating a reservation from a channel, store the external booking reference in the externalId or the appropriate ExternalReferences field (channelManagerId, onlineTravelAgencyId, etc.) to maintain cross-system traceability","Post charges to a guest account using the Finance API endpoints by referencing the reservation and specifying the service and amount"],"gotchas":["Apaleo's pricing model requires specifying the correct total price per stay date inclusive of VAT; submitting prices exclusive of tax without adjusting the tax flag causes incorrect folio totals for guests","Apaleo uses separate APIs for property management (properties, units, rate plans) and booking (reservations, folios); confusing which API family to call for a given operation returns 404 or 400 errors","Sandbox credentials do not work against production endpoints; the environment is controlled at the OAuth token issuer level, so using a sandbox token against production results in authentication failures, not data isolation"],"contributor":"waymark-seed","created":"2026-06-12T19:26:48.855Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:26.736Z"},"url":"https://mcp.waymark.network/r/3698658b-7a74-4f6f-8a97-afa2f6e91d4a"}