# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts if you happen to have a partnership with several Mirakl vendors
{% endhint %}

## Step 1 — Choose Your Authentication Method

You can now connect to Mirakl using **either an API Key** or **OAuth 2.0**.\
OAuth 2.0 is the recommended method for improved security and easier credential management.

### Option 1 — API Key Authentication

To generate the Mirakl API Key (See screenshot below):

1. Log into your desired Mirakl account: https\://\[ACCOUNT].mirakl.net/mmp/shop/user/api
2. Click on your email address on the top right corner
3. Select the tab 'API Key'
4. Copy your API Key

<figure><img src="/files/7rdyEu2AQAeNZK2BXIzH" alt=""><figcaption></figcaption></figure>

### **Option 2 — OAuth 2.0 Authentication (New)**

If your Mirakl instance supports OAuth 2.0, you can authenticate using your **Client ID** and **Client Secret** instead of an API key.

You’ll need to provide:

| Field                  | Description                                                                                    |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| **Client ID**          | The client identifier generated in your Mirakl developer portal.                               |
| **Client Secret**      | The secret associated with your Client ID.                                                     |
| **Target Environment** | The Mirakl environment you wish to connect to (e.g., development, pre-production, production). |

📘 **How to generate your Client ID and Secret:**\
Follow Mirakl’s official guide here:\
👉 [Generate Access Tokens and Client Credentials](https://help.mirakl.com/bundle/customers/page/topics/Mirakl/get_started/generate_access_tokens.html#clientid)

<figure><img src="/files/5tIdjcOO2tG8FwjB0x6u" alt=""><figcaption></figcaption></figure>

## Step 2 — Create a New Mirakl Account

To create a new Mirakl account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3\. Enter the desired information regarding, the name of the account, the Mirakl URL and the API Key

<figure><img src="/files/TXMvEC8GdVEBE8UsRujK" alt=""><figcaption></figcaption></figure>

4\. Verify the connection and Save the information

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.juble.io/channels/mirakl/add-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.