# Connect Channex

> **Plans**
>
> Everything on this page is available on every plan.

Once Channex is connected, VibeBooking can read your properties, rates and availability from it. You make one API key in Channex and paste it into the console. It takes about two minutes.

## Before you start

Check two things:

- Your role in the console is **Owner** or **Manager**. A **Viewer** cannot connect.
- You can sign in to Channex and make an API key there.

Channex does not tell us the address of the page where guests book. If you use a booking engine, have its booking page's address ready. You can also add it later ([Add your booking page](https://docs.vibebooking.ai/en/connect-channex#booking-page)).

## Connect

On **Properties** › **All**, press **Connect a reservation system** to open the **Integrations** tab. Under **Your reservation system**, press **Connect Channex**.

![The Connect Channex screen, with fields for the API key and the booking page URL and a Connect button.](https://docs.vibebooking.ai/screenshots/en/connect-channex-wizard-desktop.webp)
*Paste the API key here, and your booking page if you have one.*

1. **Open the API key settings in Channex**

   Press **Open the API key settings in Channex**. Channex's API key settings open in a new tab.

2. **Make an API key in Channex**

   Follow what the console lists:

   1. "Name the key something you will recognise (e.g. VibeBooking)"
   2. "Copy the key it shows you"

3. **Paste the API key**

   Go back to the console tab and paste it into **API key**. Spaces before or after it are fine.

4. **Enter your booking page**

   In **Your booking page (recommended)**, enter the address of your booking engine's page. You can connect with it empty.

5. **Press Connect**

   Once the key checks out, the screen moves on to "Channex is connected".

On that screen, link each Channex property to your website next. The steps are in [Link a property](https://docs.vibebooking.ai/en/go-live#link). If you did not enter a booking page, the screen says "No booking page yet. Agents have no booking link to give guests."

## Add your booking page

Agents send guests to the page you enter here. You can take a property live without one, but agents then have no booking link to give guests.

1. **Open the Integrations tab**

   Press **Properties** in the menu, then the **Integrations** tab.

2. **Enter the address**

   Under **Booking page** on the Channex card, enter the address of your booking engine's page.

3. **Press Save**

   The screen says "Booking page saved."

![The Channex card on the Integrations tab, with a field for the booking page URL and a Save button.](https://docs.vibebooking.ai/screenshots/en/connection-channex-desktop.webp)
*The Channex card on the Integrations tab, where the booking page goes.*

The address has to start with `https://` and be your own booking engine's page. A booking site's page, such as Rakuten Travel or Booking.com, cannot be used. To remove it, empty the field and press **Save**: the screen says "Booking page removed."

If your booking engine is on a different domain from your property's website, the screen says "This is not on your website's domain. That is fine if your booking engine lives on another one." If it is your booking engine's page, leave it as it is.

## Choose your VibeBooking channel

This is how bookings that come in through VibeBooking links get counted. You create one booking page (a channel) in Channex just for VibeBooking, then choose it under **VibeBooking channel** on the Channex card. Bookings made on that channel count as bookings through VibeBooking. They are counted for the channel as a whole, not per AI.

Until you set it, the card says "Not set, so bookings through VibeBooking are not counted yet."

1. **Create the channel in Channex**

   In Channex, create one channel just for VibeBooking. Put "VibeBooking" in its name and the console selects it for you. Until you have one, the card shows **Create the booking page in Channex**, which opens Channex's channels page.

2. **Choose it**

   Back on the **Integrations** tab, choose your channel from the **VibeBooking channel** list. If its name has "VibeBooking" in it, the card says "The channel named VibeBooking is selected. Save to confirm it." Channels for booking sites such as Booking.com are left out of the list.

3. **Press Save**

   The screen says "Channel ID saved."

If your channel is not in the list, open **Not in the list? Paste its ID**, open the channel in Channex, paste the address from your browser's address bar, and press **Save**. If the console could not read your channels, the field is called **Your VibeBooking channel ID** instead; paste the address there the same way.

Only an **Owner** or a **Manager** can change it.

## What VibeBooking reads

With the API key, VibeBooking reads your properties, rates and availability from Channex. It never changes anything in Channex.

Only the properties you take live are published for AI agents ([Go live](https://docs.vibebooking.ai/en/go-live#go-live)).

## When it does not work

### The key is not confirmed

If, after you press **Connect**, you see "Not confirmed. The key may be mistyped, or Channex could not be reached just now. Paste it again, or try again in a moment.", check these in order:

1. You copied the whole key. It is a long string, and copying can cut it short. Copy it again from Channex.
2. You did not paste a different key.
3. Wait a moment and press **Connect** again.

### A permission is missing

If you see "This key cannot read everything we need. Make the API key again in Channex.", open Channex again from **Open the API key settings in Channex**, make a new key and paste it.

### The booking page address is refused

A refused address shows one of these:

| Message | Why, and what to do |
| --- | --- |
| "Use an address that starts with https://." | An `http://` address cannot be used. Enter your booking engine's `https://` page. |
| "A booking site cannot be your booking page. Enter your own booking engine's address." | It is a page on a booking site such as Rakuten Travel or Booking.com. Enter the page of the booking engine your property uses. |
| "That is a VibeBooking address. Enter your own booking page." | Enter your booking engine's page instead. |
| "Take the user name and password out of the address." | The address contains a sign-in name or password. Remove them and enter it again. |
| "Check the address, for example https://book.example.jp/" | It could not be read as an address. Copy it again from your browser's address bar. |

## Disconnect

Only an **Owner** or a **Manager** can disconnect.

1. **Open the Integrations tab**

   Press **Properties** in the menu, then the **Integrations** tab.

2. **Press Disconnect**

   Press **Disconnect** on the Channex card.

3. **Confirm**

   You are asked "Disconnect Channex?". Press **Disconnect**, and the screen says "Disconnected."

4. **Delete the API key in Channex**

   Channex is not told when you disconnect. In Channex's API key settings, delete the key you made for VibeBooking.

When you disconnect:

- Reading rates and availability stops.
- Live pages stay up, but no longer show rates. To take a property off, see [Stop being live](https://docs.vibebooking.ai/en/go-live#back-to-preview).
- Nothing is deleted.

If you see "That did not work. Try again.", the connection is still there. Start again from **Disconnect**.
