Housekeeping
A Housekeeping integration pulls live information about the physical state of rooms and other space resources, allows the housekeeping staff to update the state from the Housekeeping system and pushes this data back into Mews.
Initial configuration
The integration must first retrieve all the resources the property has configured in Mews using Get all resources. The response contains all relevant information needed to map the physical configuration of the property in the external system.
'How to' use case | API Operations |
How to get the list of rooms and spaces |
Terminology: For an explanation of terms like
room,spaceandresource, see the Mews Glossary for Open API users.
Managing resources
To ensure all of the information is synchronized between the two systems, a Housekeeping integration can monitor changes to the state of a resource. Rather than polling the API for state changes, you can subscribe to notification events using Webhooks or WebSockets. Both methods support changes to resources. Don't know which one to use? See Ways to communicate.
'How to' use case | API Operations |
How to listen for changes to reservations | General Webhooks ( |
How to get reservation and customer details |
Once a staff member has cleaned or inspected a room, the state can be updated in Mews using Update resources, specifying the new state of the resource.
'How to' use case | API Operations |
How to update the state of a resource |
Resource blocks are blocks of rooms or resources set to 'out of order' or 'internal use'. Information about resource blocks can be requested using Get all resource blocks. Housekeeping integrations can also manage blocks through Add resource block and Delete resource blocks.
'How to' use case | API Operations |
How to get information about resource blocks | |
How to add a resource block | |
How to delete resource blocks |
Staff tasks
If you need to create a task directly in Mews, this can be done using Add task. If a task should be assigned to a specific department, the unique identifiers required for this action can be retrieved using Get all departments. A list of existing tasks can be retrieved from Mews using Get all tasks.
'How to' use case | API Operations |
How to add a staff task | |
How to get information about departments | |
How to get the list of staff tasks |
Dirty status
Mews allows properties to configure when a space will be marked as Dirty, upon check-in or check-out, in their Stay service settings. They can also configure a specific housekeeping time interval after which, if a space is vacant, it will automatically change state to Dirty. For example, if the field is set to two days, the space will automatically become Dirty after two days. Each unit represents a period of 24 hours, with automatic changes occurring between 04:00 and 05:00. The maximum amount of time for this time interval is 7 days, after which the state will automatically change to Dirty to adhere to regulations preventing Legionella.
Testing your integration
Please ensure you follow our general guidelines for testing integrations. In addition to this, using the demo environment credentials, you can run the Space Status Report (housekeeping report) to cross-check if the integration is working correctly.
Additional help for working with the demo environment
Help Guides:
Last updated