# 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](/connector-api/events/wh-general.md) (`ServiceOrderUpdated` event) or [WebSockets](/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](/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](/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06) with specified [Reservation states](/connector-api/operations/reservations.md#reservation-state) and [Reservation time filters](/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](/connector-api/events/wh-general.md) (`ServiceOrderUpdated` event) or [WebSockets](/connector-api/events/websockets.md) (`Reservation` event) |
| How to get reservation and customer details        | [Get all reservations](/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06)                                                            |
| How to get reservations updated over a time period | [Get all reservations](/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](/connector-api/use-cases/upsell.md) use case.

## Testing your integration

Please ensure you follow our general [Usage guidelines](/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: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.