Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 05/05/2026
FAQs ME1 / ME2 and free shipping

ME1 / ME2 and free shipping


Why does setting shipping.mode = "me1" via API not display free shipping on the front-end even with free_shipping:true on the item?

In ME1 the free_shipping:true flag may exist in the data, but Mercado Libre does not automatically interpret it as "free shipping" on the front-end or apply ME2's automatic benefits. Free shipping visibility and benefits are designed for ME2; for the front-end to display free shipping with automatic benefits, the item must be in me2 mode.

Recommendation
If you need the display and automatic free shipping benefits, verify that the item is in ME2 mode and meets the market's eligibility requirements.
Why does the API set an item to not_specified when trying to change it from ME2 to ME1?

If the account or user preferences have ME2-prioritized coexistence enabled (e.g. tags such as me2_available or commercial preferences), the platform may prevent the conversion to ME1 and return not_specified. The reason is usually account configuration and commercial preferences; converting to ME1 may require commercial intervention (KAM) to adjust shipping preferences.

Recommendation
Review the seller's commercial preferences and tags; if the conversion fails, coordinate with the commercial team to adjust the coexistence configuration.
Is ME2 required for options like "nationwide free shipping" to be automatically activated?

Yes: many automatic display rules and benefits (e.g. "Free shipping" with benefits) apply preferentially to items in ME2 mode and also depend on the price threshold and other internal policies. The global benefit cannot be forced via API if these conditions are not met.

Recommendation
Verify ME2 eligibility and required thresholds; do not attempt to force benefits via API without meeting the market conditions.
Is it possible to force nationwide free shipping via API?

No. Nationwide free shipping activation depends on automatic rules (price, logistics type such as ME2) and cannot be forced via API without meeting those requirements.

Recommendation
Adjust prices and logistics to meet market conditions; do not expect to enable nationwide free shipping through API alone.