> For the complete documentation index, see [llms.txt](https://docs.mews.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mews.com/connector-api/use-cases/customer-management.md).

# Customer management

Customer management integrations pull live information about reservations, customers, products and services, for specified time periods. Such systems allow properties to manage the entire customer journey, from automating targeted marketing and driving sales to guest communication and engagement.

## Retrieving new and modified reservations

Although new profiles can be created in Mews without a reservation, communication with a customer typically begins the moment a new reservation is created. Integration partners can listen for newly-created reservations using [General Webhooks](https://docs.mews.com/connector-api/events/wh-general.md) (`ServiceOrderUpdated` event) or [WebSockets](https://docs.mews.com/connector-api/events/websockets.md) (`Reservation` event). A new event occurs with every change to the reservation state, meaning partners are informed of any change that might lead to communication from their side, e.g. sending a custom welcome message or a post-stay survey. Reservation events contain the unique identifiers for affected reservations, these can then be used as the filter in a call to [Get all reservations](https://docs.mews.com/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06) to retrieve the required information about the customer and their stay. You can test your Webhooks or WebSockets integration by creating new reservations in Mews, which will trigger these notification events.

If Webhooks or WebSockets cannot be configured, reservation information can instead be requested using [Get all reservations](https://docs.mews.com/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06) with specified [Reservation states](https://docs.mews.com/connector-api/operations/reservations.md#reservation-state) and [Reservation time filters](https://docs.mews.com/connector-api/operations/reservations.md#reservation-time-filter). For example, using the `Updated` time filter will return all reservations modified during the time interval specified in the request.

| 'How to' use case                                  | API Operations                                                                                                                                                                                             |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| How to listen for changes to reservations          | [General Webhooks](https://docs.mews.com/connector-api/events/wh-general.md) (`ServiceOrderUpdated` event) or [WebSockets](https://docs.mews.com/connector-api/events/websockets.md) (`Reservation` event) |
| How to get reservation and customer details        | [Get all reservations](https://docs.mews.com/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06)                                                                                 |
| How to get reservations updated over a time period | [Get all reservations](https://docs.mews.com/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06)                                                                                 |

## Offering additional products or services

Each Mews property creates a unique set of services and related products which they can offer to their guests. For details on how to retrieve product information from Mews, how to search for customers, and how to correctly post orders to their profile, see the [Upsell](https://docs.mews.com/connector-api/use-cases/upsell.md) use case.

## Testing your integration

Please ensure you follow our general [Usage guidelines](https://docs.mews.com/connector-api/guidelines.md) for testing integrations.

## Additional help for working with the demo environment

> **Help Guides**:
>
> * [How to create a reservation](https://help.mews.com/s/article/create-a-reservation?language=en_US)
> * [How to check in a reservation](https://help.mews.com/s/article/check-in-a-reservation?language=en_US)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mews.com/connector-api/use-cases/customer-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
