Apaleo Integration

Connects via OAuth 2.0 client credentials. Tokens are cached and refreshed automatically. Supports availability, rates, rate plans, and reservation queries. Apaleo official site ↗

Supported features

Feature	Supported	Notes
Hotel availability	✓	Unit availability; dates auto-converted to UTC
Room types	✓	Returns property inventory
Room rates	✓	Requires rate plan ID
Rate plans	✓
List reservations	✓	Filter by date range or dateFilter
Get reservation	✓	Returns unit assignments for a reservation
Create reservation	—
Payment link	—

Setup steps

Create an application in the Apaleo Developer Portal
Go to developer.apaleo.com and sign in with your Apaleo account. Create a new OAuth application with the grant type client_credentials. After creation, copy the clientId and clientSecret.
Apaleo uses OAuth 2.0 with HTTP Basic authentication — the client ID and secret are combined as base64(clientId:clientSecret) in the authorization header. Maison handles this automatically; you only need to provide the raw values.
Find your property ID
In the Apaleo Management Console, navigate to Properties. The property ID is the short alphanumeric code shown alongside the property name (for example, MH-GRAND). You need this for the hotelConfig array.
3
Enter the credentials in the business console
Open the business console, select your client, and go to PMS Integration. Choose Apaleo and fill in:
- clientId and clientSecret — from step 1
- hotelConfig — property ID and display name from step 2
Enable the integration
Toggle Active to on and save. OAuth tokens are fetched on first use and cached in the integration record — no manual refresh needed.