Skip to content
Founding partners
All guides

Mercado Libre

Connect your Mercado Libre account

How to authorize Toldo on your Mercado Libre seller account, which permissions it asks for, how the connection is protected and when to reconnect.

Rolling outUpdated

This feature is rolling out: we're turning it on in stages with our founding partners. What this guide describes may change before general availability.

In short

You connect your account from Toldo with your Mercado Libre main user: Mercado Libre asks you to authorize Toldo and gives it an access token, never your password. If that token expires or you revoke it, Toldo pauses syncing for the account and asks you to reconnect it.

Before you start

  • Use the account's main user. Only the owner of the Mercado Libre account can authorize apps. Operators and collaborators can't.
  • Your account must be validated. Mercado Libre doesn't let accounts that are blocked or have incomplete identity validation authorize apps.
  • We're starting with Mercado Libre Mexico. Other Mercado Libre countries are on our roadmap.

Steps to connect

  1. Open Marketplaces in Toldo. In your Shopify admin, go to Toldo and open Marketplaces.
  2. Choose Mercado Libre. Click Connect. Toldo takes you to Mercado Libre's authorization page.
  3. Authorize Toldo. Sign in with your account's main user and accept the permissions.
  4. Go back to Toldo. Mercado Libre sends you back to Toldo, and you'll see your account connected, with its nickname.
  5. Review your listings. Toldo reads your active and paused listings to link them to your Shopify products. Continue with Link listings.

What permissions Toldo asks for

Toldo asks for permission to read and modify your seller account (listings, stock, prices, orders and shipping) and to keep the connection active without you having to sign in every time.

Each connected account has its own rules: what to sync, how to calculate stock and prices, whether to import orders and who invoices its sales.

How the connection is protected

  • Toldo never sees your password. You authorize Toldo on Mercado Libre's site, which gives Toldo an access token.
  • The authorization is signed. Toldo checks that Mercado Libre's response matches the request your store made, so nobody can connect another account in your name.
  • Access tokens are stored encrypted and never appear in logs. They're deleted when you disconnect the account or uninstall Toldo.

When you need to reconnect

Mercado Libre invalidates the access token when, for example:

  • you change your account password;
  • you revoke Toldo's access from Mercado Libre;
  • four months go by without the app using the account;
  • your account is blocked or its validation is incomplete.

When that happens, Toldo marks the account as Reconnect, pauses its sync and lets you know. Repeat the steps above, and syncing picks up where it left off.

Disconnect an account

When you disconnect an account, Toldo deletes its access tokens immediately and stops syncing it. Your Mercado Libre listings stay as they are, with the last stock and price Toldo sent.

Frequently asked questions

Can a collaborator on my account connect it?

No. Mercado Libre only lets the account's main user authorize apps.

Can Toldo see my Mercado Libre password?

No. You sign in on Mercado Libre's site, and Toldo only receives an access token, which you can revoke anytime.

Is Toldo an official Mercado Libre app?

No. Toldo is an independent app that uses Mercado Libre's public API with your authorization.