# API Key Access

If you want to connect an application like a Property Management System (PMS) or Revenue Management (RMS) or similar.

You will need to use the API key

## 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 you are not the billing account owner you will not have access to this

**In Staging Server it is available to all users**

If you have just subscribed and it does not show try refresh browser or logout and back in.

In the [Organisation Page](https://staging.channex.io/organization/api-keys) you will see a section: `API Keys`.

![API Key management interface](https://2514252617-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWLG7_BCMgWd3mn6DYg%2F-MfaHMHm6xAzxmRGeTbL%2F-MfaKWZZTTMOanKPJZbN%2Fimage.png?alt=media\&token=2d6473ad-0101-4417-a7c0-39fa550297d8)

Press `Create new API Key`, fill the API Key name and press `Create` to generate a new API Key.

You can make a API key for all properties or select some properties only.

<figure><img src="https://2514252617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWLG7_BCMgWd3mn6DYg%2Fuploads%2FLjnIyY8umBn9frpOz0yp%2FScreenshot%202023-01-26%20at%2020.28.12.png?alt=media&#x26;token=5dd72a39-3662-4daf-a5c6-5a1b15b29e0d" alt=""><figcaption></figcaption></figure>

After that, you should see this next message:

![Generated API Key Interface](https://2514252617-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWLG7_BCMgWd3mn6DYg%2F-MfaHMHm6xAzxmRGeTbL%2F-MfaMKkMnENBR1b57f7f%2FGroup.png?alt=media\&token=f8302953-8417-4190-b440-129992ef4971)

{% hint style="warning" %}
Please, copy the API Key and keep it in a safe place.\
The API Key will only be shown once.\
If you lose the API Key, you can generate a new one.an
{% endhint %}

## API Key for 1 or more Properties

Sometimes you need to share only 1 or 2 properties instead of all properties in your account, this is useful for connecting a 3rd party system like a Revenue Management application

<figure><img src="https://2514252617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LWLG7_BCMgWd3mn6DYg%2Fuploads%2FFZvfpMCDR6NNDCaewIkr%2FScreenshot%202023-05-26%20at%2015.48.12.png?alt=media&#x26;token=a6dece63-95bd-45e0-a533-a5b11b5a82c9" alt=""><figcaption></figcaption></figure>

Just unselect the "Access to all properties" box and you will get a list of properties to select. The API will only be allowed to access the selected properties

##

## 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 an API Key

Sometimes, an API Key can get 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](https://2514252617-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LWLG7_BCMgWd3mn6DYg%2F-MfaHMHm6xAzxmRGeTbL%2F-MfaO6AR3EYWc9ePaT3n%2Fimage.png?alt=media\&token=59158df4-ec46-4be3-b9fd-ccf983f1a218)

## What is possible via the API Key

Using the key you will get access to the same powers as the user itself.

If you made an API key for a specific property then you only can access those properties selected.