> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/sales-channels/mercado-libre-integration.md).

# Mercado Libre Integration

> New to Order Desk? Order Desk collects all your orders from all your sales channels in one place and sends them to your chosen fulfillment services automatically.
>
> <i class="fa-computer" style="color:$primary;">:computer:</i> [See all integrations](https://www.orderdesk.com/integrations/) . <i class="fa-wallet" style="color:$primary;">:wallet:</i> [Pricing](https://www.orderdesk.com/pricing/) . <i class="fa-arrow-right" style="color:$primary;">:arrow-right:</i> [Start free trial](https://app.orderdesk.me/account-setup)

Order Desk can import your [Mercado Libre](https://www.mercadolibre.com/) orders, process them, and send them for fulfillment based on the settings you choose. As orders are fulfilled, tracking details can automatically be sent back to Mercado Libre.

### Setup

To connect to your Mercado Libre account, click on **Manage Integrations** in the left sidebar. Under the **Shopping Carts** tab, find and enable the Mercado Libre integration.

<div data-with-frame="true"><figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F7O1YXQAXuVYlaeSjTSMo%2FCleanShot%202026-10-26%20at%2015.44.39%402x.png?alt=media&amp;token=f321d271-96e8-47ab-9912-7e0a3bd5a487" alt=""><figcaption></figcaption></figure></div>

Alternatively, search for *Mercado Libre* from the available integrations search.

<div data-with-frame="true"><figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FC4nxMNZ3rMcMEtllBqIN%2FCleanShot%202026-10-26%20at%2015.45.50%402x.png?alt=media&amp;token=227713c0-8a6d-48a9-ab1d-1f6de512dc43" alt=""><figcaption></figcaption></figure></div>

Once enabled, you will be taken to a page where you can create a Mercado Libre application to connect your account to Order Desk.

### Create Your Mercado Libre Application

<div data-with-frame="true"><figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F7Vk8TI5b2No3bR92WMpy%2FCleanShot%202026-10-26%20at%2016.40.41%402x.png?alt=media&amp;token=f77081fe-be3e-42dd-9b50-2bde55dc3071" alt=""><figcaption></figcaption></figure></div>

Before connecting, you will need to create an application in the Mercado Libre Developer Center.

#### Select Your Country

Select the country where you sell on Mercado Libre from the Country dropdown. This determines which Mercado Libre site you will use to create your application.

#### Open the Mercado Libre Developer Center

Click the **Open the Mercado Libre Developer Center** button. If you aren't already logged in, sign in with the same Mercado Libre account you use to sell.

{% hint style="warning" %}
You must use the main account associated with your Mercado Libre store. Employee or collaborator accounts cannot be used to authorize the connection.
{% endhint %}

#### Create Your Application

In the Mercado Libre Developer Center, click **Create new application**. Fill out the application form using the following details:

* **Name**: Enter a name for the connection, such as `Order Desk - Your Store Name`. Include your store name to make the application easy to identify.
* **Short Name:** Enter a name using only letters, numbers, and hyphens, such as "*orderdesk-`yourstore`*".
* **Description:** Enter "*Sends my Mercado Libre orders to Order Desk"*.
* **Logo**: Upload a square image, such as your store logo.
* **Redirect URI**: Enter `https://app.orderdesk.me/oauth/mercadolibre`.
* **OAuth Flow**: Select **Authentication Code**, **Client Credentials**, and **Refresh Token**.
* **Use PKCE:** Leave this disabled.
* **Device Grant:** Leave this disabled.
* **Scopes / Permissions**: Select **Read**, **Write**, and **Offline access**.
* **Topics / Notifications**: Leave these empty.

#### Save Your Application

Accept the terms and click **Create application**. Once the application has been created, Mercado Libre will provide an **App ID** and **Secret Key**.

Copy these credentials into the corresponding fields in Order Desk. You may need to click **Show** in Mercado Libre to reveal your Secret Key.

<div data-with-frame="true"><figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FyUJYKj9OypNsSPJM1gb5%2FCleanShot%202026-10-26%20at%2016.45.32%402x.png?alt=media&amp;token=53b4b3c5-2df7-4ab2-84d1-faa82e0af1cf" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Please note that Order Desk isn't able to help find or reset your Mercado Libre credentials.
{% endhint %}

#### Authorize Order Desk

Once you've entered your App ID and Secret Key, click **Continue**.

On the next page, click the green **Connect To Mercado Libre** button.

<div data-with-frame="true"><figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F9C4wePZgEizASVguNu6r%2FCleanShot%202026-10-26%20at%2016.46.32%402x.png?alt=media&amp;token=a196051b-7ad6-478a-8cc8-42447fbc3cc0" alt=""><figcaption></figcaption></figure></div>

You will be redirected to Mercado Libre, where you will need to log in and click **Authorize** to grant Order Desk access to your account.

Once authorization is complete, you will be redirected back to Order Desk and your account will be connected.

### Integration Settings

Once connected, set your preferences in the Mercado Libre integration settings.

<div align="left" data-with-frame="true"><figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FNTi1l6D6Z92sUQCVB0XE%2FCleanShot%202026-10-26%20at%2015.50.21%402x.png?alt=media&amp;token=fd1e8ed8-5cb6-4ec1-bf46-e2b7a718d057" alt="" width="563"><figcaption></figcaption></figure></div>

#### Check for New Orders

Select how often you want Order Desk to look for and import new Mercado Libre orders.

#### Folder for New Orders

Select the folder where newly imported orders from Mercado Libre should be placed. For more information, see the [Working with Folders](https://help.orderdesk.com/guided-walkthroughs/orders-and-folders/organizing-orders-with-folders.md) guide.

#### Order Status Filter

Choose which Mercado Libre orders you want Order Desk to import based on their current status. For example, select **Paid** if you only want to import orders that have been paid for.

#### Sync Tracking Numbers

Select whether or not to automatically send shipment details back to Mercado Libre as orders are fulfilled.

#### Sync Inventory

If you want Order Desk to sync your inventory availability back to Mercado Libre, enable the Sync Inventory setting. As inventory counts are updated in Order Desk, those numbers will be sent back to Mercado Libre.

#### Order Prefix

If you need your order numbers to have a prefix when they are imported into Order Desk, set that prefix here.

#### Country Filter

Select the countries you want to filter orders by from the dropdown menu.

Choose **Standard** for Order Desk to only import orders from the selected countries. Choose **Inverted** to import orders from all countries except those selected.

#### First Import Date

Any orders placed before the date set here will not import into Order Desk.

### Manual Imports

You can manually import orders from Mercado Libre at any time.

Under **Import Orders**, select your preferred import method:

* **Date:** Select a starting date to import orders placed on or after that date.
* **Order ID:** Enter a specific Mercado Libre Order ID if you only need to import one order.

<div align="left" data-with-frame="true"><figure><img src="https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F097RnhEQVdnAnXDozssF%2FCleanShot%202026-10-26%20at%2015.50.34%402x.png?alt=media&amp;token=41c91d3f-7af2-4d1c-b797-e4fd832ec120" alt="" width="563"><figcaption></figcaption></figure></div>

Click **Import Orders** to begin importing.

{% hint style="info" icon="lightbulb" %}
If Mercado Libre has a large number of orders in the selected date range, you may need to click the Import Orders button a few times to bring them all in.
{% endhint %}

### Order Import Log

If an order from your cart hasn't come into Order Desk, the **Order Import Log** is a good place to start. It shows recent import attempts, including which orders were imported or skipped and any skip reasons.

Learn how to use the log in the [How to Troubleshoot Missing Shopping Cart Orders](https://help.orderdesk.com/guided-walkthroughs/integration-specific-walkthroughs/how-to-troubleshoot-missing-shopping-cart-orders.md) guide.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.orderdesk.com/integration-setup-guides/sales-channels/mercado-libre-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
