Channex.io
Search…
Channex.io Documentation
Changelog
For OTA
Intro
Channex Shopping API
Open Channel API
FOR PMS
API Reference
Rate Limits
Properties Collection
Property Users Collection
Groups Collection
Group Users Collection
Room Types Collection
Rate Plans Collection
Availability and Rates
Subscriptions Collection
Webhook Collection
Bookings Collection
Channel API
Photos Collection
Hotel Policy Collection
Facilities Collection
Taxes and Tax Sets
Messages Collection
Reviews Collection
Channel Codes
Channel IFrame
PMS Certification Tests
Guides
PMS Integration Guide
Best Practices Guide
Channex PCI
Overview
Registration & Authentication
API Key and Session Tokens
Card API
Card Capture IFrame API
Show Card Iframe API
Profile List
Tokenisation Profile
Detokenisation Profile
Drop In's
Custom Secure URL Endpoint
Account usage
FAQ
Examples
Walkthough
Channex PCI Certification
Application Documentation
Overview of App Documentation
Dashboard
Properties and Groups Management
Property Tasks
Rooms Management
Inventory Management
Channels Management
Channel Actions Log
Bookings Management
Availability Modifiers
API Key Access
Google Guide
Connect Google Channel
Linking Google Ads
Create a Hotel Campaign
My Hotel Shop (MHS) Google
Channel Mapping Guides
Agoda
Airbnb
Booking.com
Ctrip / Trip.com
Expedia
Despegar
Hostelworld
HyperGuest
Hotelbeds
Traveloka
VRBO (BETA)
Powered By GitBook
API Key Access
Persistent API Key access without refresh requirements
If you develop a server-side application like a Property Management System (PMS) or Revenue Management (RMS) or similar.
You will need to use the API key method instead of user credentials
In the future logging in with user credentials will trigger 2-factor authentication which will break your integration.

Setup an API Key

This feature is not available for all Users by default, to enable it you will need to have an active subscription.
If we have just subscribed and it does not show try refresh browser or logout and back in.
In the User Profile you will see a new section: API Keys.
API Key management interface
Press Create new API Key, fill API Key name and press Create to generate a new API Key.
Create new API Key Interface
After that, you should see the next message:
Generated API Key Interface
Please, copy the API Key and keep it in a safe place. API Key will only be shown once. If you lose the API Key, you can generate a new one.

API Key Usage

To send an API requests using the API Key, you should pass it as user-api-key header into request.
GET /api/v1/properties/ HTTP/1.1
Host: staging.channex.io
Content-Type: application/json
user-api-key: uU08XiMgk8a7CrY4xUjAReUIuTrn83R123adaVb8Tf/qMcVTEgriuJhXWs/1Q1P

Revoke API Key

Sometimes, an API Key can be compromised. This can happen for many different reasons - forgetting the key at a git repo or something else. If you think your API Key is compromised you can revoke that key.
At your User Profile, find your key at list and press Actions button, choose Withdraw action and confirm action.
The API key will still be listed and not removed, just disabled.
Revoke API Key Interface

What is possible via the API Key

Using the key you will get access to the same powers as the user, but you don't have to use username and password to login.
Application Documentation - Previous
Availability Modifiers
Next - Google Guide
Connect Google Channel
Last modified 9mo ago
Copy link
On this page
Setup an API Key
API Key Usage
Revoke API Key
What is possible via the API Key