> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abrahospitality.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Maestro

> Connect ABRA to Maestro PMS

# Maestro Integration

ABRA integrates with Maestro PMS to provide real-time synchronization of guest and reservation data.

## What Data Syncs

The following data is automatically synchronized from Maestro to ABRA:

* **Reservations** - Booking details including confirmation number, arrival/departure dates, and status
* **Guest Profiles** - Name, contact information, and guest history
* **Room Assignments** - Current room numbers and room types
* **Check-in/Check-out Events** - Real-time status updates as guests arrive and depart
* **Rate Information** - Room rates and booking details

## How Sync Works

ABRA uses multiple methods to keep your data synchronized with Maestro:

### Real-Time Webhooks

<Info>
  Real-time webhooks are the primary method for keeping ABRA in sync with Maestro. All reservation and guest data flows through these event notifications.
</Info>

Maestro sends event notifications to ABRA when changes occur. These updates are processed within moments of occurring in Maestro.

**Reservation Events:**

| Event                                                                           | Description                     |
| ------------------------------------------------------------------------------- | ------------------------------- |
| [Reservation List](/integrations/pms/maestro/events/reservation-list)           | Batch of reservation updates    |
| [Reservation Created](/integrations/pms/maestro/events/reservation-created)     | A new booking is created        |
| [Reservation Modified](/integrations/pms/maestro/events/reservation-modified)   | An existing booking is modified |
| [Reservation Cancelled](/integrations/pms/maestro/events/reservation-cancelled) | A reservation is cancelled      |
| [Check-In](/integrations/pms/maestro/events/check-in)                           | A guest checks into their room  |
| [Check-In Sharer](/integrations/pms/maestro/events/check-in-sharer)             | A room sharer checks in         |
| [Check-Out](/integrations/pms/maestro/events/check-out)                         | A guest checks out              |

**Guest Events:**

| Event                                                                       | Description                    |
| --------------------------------------------------------------------------- | ------------------------------ |
| [Guest Created](/integrations/pms/maestro/events/guest-created)             | A new guest profile is created |
| [Guest Modified](/integrations/pms/maestro/events/guest-modified)           | Guest information is modified  |
| [Client Changes List](/integrations/pms/maestro/events/client-changes-list) | Batch of guest profile updates |
| [Client Merge List](/integrations/pms/maestro/events/client-merge-list)     | Guest profiles are combined    |
| [Client Purge List](/integrations/pms/maestro/events/client-purge-list)     | Guest profiles are removed     |
| [Member Changes List](/integrations/pms/maestro/events/member-changes-list) | Loyalty member updates         |

**Room Events:**

| Event                                                                       | Description                             |
| --------------------------------------------------------------------------- | --------------------------------------- |
| [Room Status](/integrations/pms/maestro/events/room-status)                 | Current room availability               |
| [Room Status Changed](/integrations/pms/maestro/events/room-status-changed) | Room availability or assignment changes |
| [Housekeeping Status](/integrations/pms/maestro/events/housekeeping-status) | Room cleaning status                    |
| [Housekeeping Update](/integrations/pms/maestro/events/housekeeping-update) | Room cleaning status changes            |

**Other Events:**

| Event                                                       | Description           |
| ----------------------------------------------------------- | --------------------- |
| [Guest Folio](/integrations/pms/maestro/events/guest-folio) | Billing/folio updates |

## Reservation status mapping

For a full explanation of ABRA reservation statuses (including display-only “Arrivals” and “Departures”), see [Reservation Statuses](/concepts/reservation-statuses).

Maestro provides both reservation update events and explicit arrival/departure events. ABRA updates reservation status primarily from these events:

* [`Check-In`](/integrations/pms/maestro/events/check-in) and [`Check-In Sharer`](/integrations/pms/maestro/events/check-in-sharer) → **In-House**
* [`Check-Out`](/integrations/pms/maestro/events/check-out) → **Past**
* [`Reservation Cancelled`](/integrations/pms/maestro/events/reservation-cancelled) → **Cancelled**
* Reservation create/modify events update dates/rooms/guests and may also update status fields

### Maestro event → ABRA status

| Maestro Event                  | ABRA Status   |
| ------------------------------ | ------------- |
| `Check-In` / `Check-In Sharer` | **In-House**  |
| `Check-Out`                    | **Past**      |
| `Reservation Cancelled`        | **Cancelled** |

### Scheduled Sync Jobs

<Warning>
  Scheduled sync jobs are deprecated and will be removed in a future release. Real-time webhooks cover all these events and these polling jobs are redundant.
</Warning>

Currently, ABRA also runs scheduled jobs as a legacy fallback:

| Job                   | Frequency        | Data Range                        |
| --------------------- | ---------------- | --------------------------------- |
| Full Reservation Sync | Every 2 hours    | 2 weeks back, 2 months forward    |
| Status Sync           | Every 15 minutes | Recalculates reservation statuses |

**Overlap with Webhooks:**

* Reservation created/modified/cancelled webhook events duplicate the "Full Reservation Sync" polling
* Guest created/modified webhook events duplicate guest data in the polling sync
* Check-in/check-out webhook events duplicate the "Status Sync" polling

### Initial Setup Sync

During initial setup, ABRA imports your historical reservation data to ensure you have a complete picture from day one. This one-time sync runs automatically until all historical data is imported.

## Initial Setup

To connect ABRA to Maestro, you'll need the following from your Maestro administrator:

* **Hotel ID** - Your property identifier in Maestro
* **API URL** - Your Maestro API endpoint
* **API Passkey** - Authentication credential for secure communication

Your ABRA implementation team will work with your Maestro administrator to obtain these credentials and configure the connection.

## Sync Status

Once connected, you can verify data is syncing correctly by checking that recent reservations and guest updates from Maestro appear in ABRA. Contact ABRA support if you notice any discrepancies.