Your integration journey

For a general overview and step-by-step guide to the integration process for all Mews Open API integrations, see Your journey with Mews. This page provides guidance specific to integrating with the Mews Channel Manager API.

Step 1: Exploration

Before you begin, review the documentation to understand the available API Operations and their uses:

• API Operations (Mews)

• API Operations (CHM)

Step 2: Registration

To register your integration, follow the process outlined in the main onboarding guide Your journey with Mews.

Obtain your Client Token: Once approved, you will receive a Client Token that uniquely identifies your application. This token remains the same across all properties but differs by environment (i.e. Demo vs. Production).

Step 3: Development

Channel Manager system setup

1. Set up inbound endpoints Prepare your Channel Manager-side API endpoints to accept requests from Mews, using the same Client Token provided for Mews-side authentication.

While you can use a different token, we recommend using the same one for simplicity.

1. Share your endpoints with Mews Send Mews the endpoint URLs for each supported Channel Manager API Operation.

You can submit the URLs incrementally during development. Production URLs can be shared later if preferred.

Property connection for testing

For testing in the Demo environment, Mews integration specialists will handle the connection setup to a test property. To understand how property connections work in general, see Connecting a property.

Step 4: Certification

Before going live in Production, your integration must be certified by Mews. The process depends on your registration pathway:

• Partner Portal: Log in and go to Integrations → Certify Existing Applications.

• No Partner Portal access: Complete the Certification Form.

Learn more:

• Certification

• Certification tests

• Channel API Certification: What to expect

Step 5: Go live

After successful certification:

• You will receive a Client Token for the Production environment.

• Mews will activate the connection at the agreed pilot property.

• Your integration will be monitored for a short period (typically 4 weeks).

Following a successful pilot, your integration can be published to other properties or listed on the Mews Marketplace (if public).

For general support, visit the Mews Help Center.

Connecting a property

To connect an individual property to your system, follow these steps:

1. Create the connection in Mews: A connection must first be established in Mews Operations. This can be done by the property.

   • All spaces and rates are automatically assigned default mapping codes.

   • If your system requires specific mapping codes, communicate them in advance so the property can adjust accordingly.

2. Obtain the Connection Token: The Connection Token identifies the specific link between the property and your system. You can get it in two ways:

   • Use the Get properties API operation to retrieve all connections and identify new ones.

   • Or request the token directly from the property.

3. Retreive the connection configuration: Fetch the connection’s configuration to complete the setup:

   • Use the Get configuration API operation.

   • Or request configuration details manually from the property.

4. Configure the connection: Configure the connection on your channel manager system to finalize the integration.

Demo environment: For integrations in the Demo environment, Mews integration specialists handle all connection requests.