> For the complete documentation index, see [llms.txt](https://docs.juble.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.juble.io/channels/mirakl/add-account.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.