Developers

Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.

Last update 15/12/2025

Create application

Welcome to the first steps to start using our APIs. By following this guidance you will be able to create your first application.

Register account

To start using the Global Selling APIs, you must have a registered account. You can register in one of the following ways:

By invitation from the commercial team.
Through self-registration on the Global Selling Landing Page.

Once registered, you can:

Create an application.
Execute authentication and authorization flows to obtain access and refresh tokens.
Understand the different types of users.
Test flows using test users.
Learn more about the Applications API.
Understand the security methods required to execute our APIs.

If you have any additional questions, you can consult Seller Learning Center or Global Selling Help.

Create application

If you have already created your user account, please go to https://global-selling.mercadolibre.com/devsite

Click "Login" and enter your credentials. (If you're already logged in, you can proceed directly to the next step.)

Now, please go to https://global-selling.mercadolibre.com/devcenter and link your account.

When you link your account you will belong to Mercado Libre developers community in charge of creating electronic commerce tools and solutions.

Congrats! Now you have access to create an application.

Note:

Before creating an application, make sure the account you are using is the owner account for the solution you intend to develop. This helps avoid potential account transfer issues in the future. We recommend creating the account under a legal entity.

By clicking on "Create new application" you access the following page.

Basic information

Here you must complete your application's basic information:

Name: The name of your application. Maximum 50 characters. It must be unique within the site.
Short Name: This will be used by Mercado Libre to generate your application URL. Maximum 50 characters, using only letters, numbers, and underscores.
Description: Briefly describe what your application does. Maximum 150 characters.
Logo: Upload a PNG image (400x400 pixels, under 100 KB). We recommend using a white background for best results.

And then click to "Continue"

Configurations and scopes

Now, you will set your Configuration and permissions:

Redirect URI: This is the URL to which the user will be redirected after authentication. The address must begin with https:// — using the HTTPS protocol is mandatory to ensure that the message is encrypted and only accessible to authorized users. If you're still using HTTP, please update your redirect URI to use HTTPS.
PKCE (Proof Key for Code Exchange): This setting determines whether PKCE validation will be enabled for token generation. Enabling PKCE adds an extra layer of security by performing a second check to help prevent authorization code injection and CSRF (Cross-site Request Forgery) attacks. Its use is optional.
Business units: Please choose Mercadolibre.
Permissions (Scopes): You must configure the functional permissions for your integration. These permissions are required for users to authorize your application, granting the appropriate access and enabling correct use of our APIs on their behalf.
- Read only: allows the use of API GET HTTPS methods.
- Read and write: allows the use of API PUT, POST and DELETE HTTPS methods.

Notification configuration

Topics: List of topics you want to subscribe to receive notifications about changes on APIs. There are more than ten possible topics: marketplace orders, items, marketplace items, marketplace questions, marketplace messages and marketplace claims. See more about Notifications.
Callback URL Notifications: URL to return users to your app after they grant access. Configure the public URL of your domain where you want to receive the notifications on the different topics.

Accept terms and conditions and click on "Create application".

Done! You will be redirected to My Applications. There you will have your application created with the name of application and app id.

More information regarding Scopes & connected resources

Users (default)

This permission is active by default in all created applications. It allows consumption of users' resources, allowing you to obtain information from a Mercado Libre registered and authorized account.

Publication and synchronization

This is a permission that allows your application to create, update, pause and/or delete one or all store listings. It allows access to the resources of items, pictures, prices and more.

Questions & Answers, post-purchase communication, claims and returns management

Allows your application to read and send Questions & Answers, post-purchase messages, manage claims and returns. Allows access to resources of Questions & Answers, post-purchase messages, claims and returns.

Advertising

This is a permission that allows your application to access, create and manage advertising campaigns. Allows access to Advertising resources.

Business metrics

This is a permission that allows your application to follow the metrics and indicators regarding sales, stock and reputation, as well as fiscal information, balances and operation reports. Allows access to trends, highlights, visits and more resources.

Sales and shipping

This is a permission that allows your application to manage sales and shipments such as dispatches, returns, chargebacks and claims. Allows access to orders, shipments, claims and returns resources.

Promotions, coupons and discounts

This is a permission that allows your application to access, create, and manage offers and coupons. Allows access to offers and deals resources.

Billing

This is a permission that allows your application to send invoices and manage billing details, besides monitoring income, movements, account balances and all billing reports. Allows access to invoices, billing and more resources.

Billing data

Next: Authentication and Authorization.