---
updatedAt: 2026-02-17T21:56:59.000Z
agentTools:
  projectIndex: https://docs.myfatoorah.com/llms.txt
---

# API Key

## Overview

The API Key is required to authenticate your application with the MyFatoorah API.\
Use this token in your API requests to ensure secure communication between your system and MyFatoorah services.

## API & Portal URLs

| **Country / Environment**         | **API URL**                       | **Portal URL**                                                                   |
| --------------------------------- | --------------------------------- | -------------------------------------------------------------------------------- |
| **Test (Sandbox)**                | <https://apitest.myfatoorah.com/> | [https://demo.myfatoorah.com/](https://demo.myfatoorah.com/En/All/Account/LogIn) |
| **Kuwait, Bahrain, Jordan, Oman** | <https://api.myfatoorah.com/>     | <https://portal.myfatoorah.com/>                                                 |
| **UAE**                           | <https://api-ae.myfatoorah.com/>  | <https://ae.myfatoorah.com/>                                                     |
| **Saudi Arabia**                  | <https://api-sa.myfatoorah.com/>  | <https://sa.myfatoorah.com/>                                                     |
| **Qatar**                         | <https://api-qa.myfatoorah.com/>  | <https://qa.myfatoorah.com/>                                                     |
| **Egypt**                         | <https://api-eg.myfatoorah.com/>  | <https://eg.myfatoorah.com/>                                                     |

## How to Generate Your API Token Key

**You can get your API key as follows:**

* Log in to your MyFatoorah account using your Super Master Account.
* From the side menu, select **Integration Settings → API Key**
* Click the Add button to generate a new key.
* You will be redirected to a page where you can configure the key settings:
  * **Name:** A custom label for your token.
  * **Expiry Date:** Define when this key will expire.
  * **Active Status:** Choose whether the key is active or inactive.
  * **Permissions:** Select which API endpoints the key can access, and you can assign custom permissions like Super Rules, Create Payments, Update Payments, etc.
* After filling in the details, scroll down and click Create to generate the new API key.
* Once created, your key will appear in the list.
* Click on the Copy icon next to the key to copy it and start using this key in your integration.

![](https://files.readme.io/04f3c4ee07034ca0c83689bf50a43d8cf95313e782bae4dadf7d4347a1085963-newkey.PNG)

![](https://files.readme.io/64708704d4bf88b3109ecb3bc59ad6607d7e5e53d80289c072392e53c28e77b5-image.png)

<Callout icon="🚧" theme="warn">
  **Important Notes**

  * You can **create up to 5 API keys** only.

  * If you use a token to access an endpoint **without the required permissions**,  
    you will receive the following error:  
    `Status Code: 401
    , Message: "The token does not have the required permissions!"`

  * You can edit an existing API key by clicking the Edit icon next to it. This allows you to update the name, permissions, status, or **delete** the key.
</Callout>

<Callout icon="📘" theme="info">
  **Request Header**

  Add **"Authorization": "Bearer token"** to request header. Token of demo configuration can be found [here](https://docs.myfatoorah.com/docs/api-key#test-demo-token).
</Callout>

<Callout icon="❗️" theme="error">
  **Legacy API Key**

  If you are using a legacy API Key, it will remain valid until it expires. After that, you will be forced to use the new version of the API Keys.

  ![](https://files.readme.io/1f16ba20cf7a1ea5c86ced8167fadf0c6673542e4b467e52d8af5ab6182deea1-image.png)
</Callout>

<Callout icon="📘" theme="info">
  **Multi-Country Account**

  Each enabled country in your portal account has a different API token key. You have to use the API token key of each country in your integration to allow your customer to pay in their local currency.
</Callout>

<Callout icon="❗️" theme="error">
  **Disable user**

  Please, avoid disabling the user who created the token, as it will disable the token key.
</Callout>

## Test (Demo) Token

To test your integration without real transactions, create a demo account by registering at <https://registertest.myfatoorah.com/en/> , selecting Kuwait as the country, and skipping the bank details step. After completing the registration, email <tech@myfatoorah.com> to activate your demo account and enable the required features.

**Public Test API Token Key**

You can also use the public test token provided by MyFatoorah.\
Click the **copy icon** 📋 next to the token box to copy it.

```
SK_KWT_vVZlnnAqu8jRByOWaRPNId4ShzEDNt256dvnjebuyzo52dXjAfRx2ixW5umjWSUx
```

<br />