# Manage API Keys

The **Manage API Keys** view of the Emporix Developer Portal is the place where you access the API keys connected to your tenants. API keys allow you to access API from either business or a customer's perspectives.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-3aa94a43b365dc57ce5941854c02dff49196ed0c%2Fapikeys.png?alt=media" alt=""><figcaption></figcaption></figure>

When you create an Emporix tenant, you obtain keys to the following types of :

| API type           | Description                                                                                                                                   |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Emporix API**    | Used to access and manage your tenant's resources. With this key, you have access to all services and scopes within the application.          |
| **Storefront API** | Used to access storefront application to perform basic e-commerce actions like browsing products, viewing prices, or adding products to cart. |
| **Custom API**     | Used to define your own keys for separate services and with specific scopes.                                                                  |

To authorize API requests, you need `Client ID` and `Secret` of a specific API key depending on the request you want to send. You can easily copy the credentials with the **copy** icon or view the `Secret` with the **preview** icon. Also, it is possible to regenerate the API keys by choosing the **renew** option.

<div align="left"><figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-9c1673ef09e37ea76375922b7a3ee10ecd54677e%2Ficons.png?alt=media" alt="" width="116"><figcaption></figcaption></figure></div>

## Custom API keys

You can create your custom API keys for various purposes. It is possible to define separate API keys for different services that contain some specific scopes. This way the application stays more secure. The custom API keys are assigned to the specific tenant.

### Creating custom API keys

1. If you don't have any custom API keys, in the **Manage API Keys** view choose the **Create scopes** in the **Custom API** row. Once you have already defined some API keys and want to define more scopes, expand the **Custom API** and choose **Add custom API**.
2. Enter the name for your custom keys and select the scopes of your interest. You can choose scopes from different services.

   <figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-5ad5551aee1fce469d40c74c541880b062feb4fe%2Fscopes.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Confirm with **Generate** and the created group appears under **Custom API**.

   <figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-1e42119ad7e9a24abd357d7852bd86b8c7b207ee%2Fcustomkeys.png?alt=media" alt=""><figcaption></figcaption></figure>

## Quick start sample

For easier start of working with API keys, you get a preview of sample requests. Choose the **Get started** option next to the selected API key to get a preview of an example request.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-544c4f35abe5bc45daf12529c5e3a2d4f29a15ac%2Fsample.png?alt=media" alt=""><figcaption></figcaption></figure>