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: you authorize Toldo on Mercado Libre, which gives it an access token and never your password, and then you confirm in Toldo which store it connects to. If that token expires or you revoke it, Toldo stops syncing the account and asks you to reconnect it.

Before you start

  • Use the account's main user. Only the holder 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. Today Toldo connects one Mercado Libre Mexico account per store, with the Connect Mexico button. Accounts from other countries (Brazil, Argentina, Chile, Colombia) and a second account on the same store are opening in stages, founding partners first: write to us if you need them.
  • Get your SKUs ready. As soon as you connect, Toldo links your listings and sends them your Shopify stock. See Link listings.

Steps to connect

  1. Open Mercado Libre in Toldo. In your Shopify admin, go to Toldo. On Home, the Get set up guide starts with this step, with the Connect Mercado Libre México button; you can also open Mercado Libre in the menu.
  2. Click Connect Mexico. Under Connect your Mercado Libre account, click Connect Mexico. 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. Confirm the connection. Mercado Libre takes you to a Toldo page that asks Connect [your account]? and shows your account and your Shopify store. If they're right, click Connect. Toldo takes you back to your Shopify admin, to the account's page. If you take more than 15 minutes, start again.
  5. Check your listings. Within a minute, Toldo starts reading your active and paused listings, links them to your Shopify products and sends them stock with the default rules: all locations, no units held back and no maximum. Prices don't change until you turn on sending them. Only orders placed after you connect are imported into Shopify. Continue with Link listings.

Setup guide

After you connect, the account's page shows a guide with the steps left, in order, and marks the ones you've finished as Done. It updates by itself from what Toldo sees:

  • Connect your Mercado Libre account. Done while the account is connected.
  • Link your listings. Done when every listing has its Shopify product or is ignored. See Link listings.
  • Review your sync rules. Done when you save the account's rules or, in Mexico, when you confirm who invoices your sales.
  • Set up your CFDI. Only if you chose Toldo to invoice these sales: done when you connect your CFDI issuer.
  • Receive your first order. Done when your first Mercado Libre order reaches Shopify.

Toldo's home page also shows each account's next step. Once you finish, the guide goes away; you can also hide it with Hide this guide.

What permissions Toldo asks for

Toldo asks for permission to read and change your seller account (listings, stock, prices, orders and shipments) and to keep the connection active without you having to sign in each 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. A Mercado Libre account can only be connected to one Shopify store at a time: if it's already connected to another one, disconnect it there first.

How the connection is protected

  • Toldo never sees your password. You authorize it 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 no one can connect another account in your name.
  • Tokens are stored encrypted and never appear in the logs. They're deleted when you disconnect the account or uninstall Toldo, and either way Toldo also withdraws its access on your Mercado Libre account. If Mercado Libre doesn't answer at that moment, withdraw it yourself from your Mercado Libre account.

When you need to reconnect

Mercado Libre invalidates the access token when, for example:

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

When that happens, Toldo stops syncing the account, marks it as Reconnect needed and shows a notice on Home, in Mercado Libre and on the account's page. Click Connect again, authorize again on Mercado Libre and confirm with Connect. Your links and rules are kept and syncing picks up where it left off; Toldo imports the orders placed in the meantime, up to 30 days back.

Email alerts

When an account needs you, Toldo emails you within minutes, as well as recording it in the account's Activity:

  • it must be connected again (or, on Amazon, its authorization renewed soon);
  • an order couldn't be created in Shopify;
  • your plan's orders for this month ran out;
  • a cancellation Shopify couldn't apply, or one that came after shipping (a return to handle);
  • Toldo lost its access to your store and can't sync anything.

If several things happen in a row, they come in one email, with the link to the account. The email goes to the address Shopify uses to write to you about your store. To stop them for an account, untick Email me when this account needs me in its sync rules.

If Toldo loses access to your store

Toldo works on your store with a permission that Shopify renews every hour. If Shopify stops renewing it, Toldo can't read your stock or create orders: nothing syncs, and the pending jobs wait, without being lost.

  • The alert. Toldo emails you once the problem has lasted half an hour, in case it was passing.
  • The reminders. While it stays that way, it reminds you the next day, two and three days in, and then once a week, up to a month; after that it stops writing. Each reminder says how many days it has lasted and how many of your store's jobs are waiting.
  • How to fix it. Open Toldo in your Shopify admin: that makes Shopify give it a new permission. When access is back, the waiting jobs go on and you get an email saying it's fixed.

These emails carry counts only: never your buyers' data. If you uninstall Toldo, you get none of them.

Disconnect an account

If you only want to stop syncing for a while, use Pause syncing on the account's page: no stock, prices or orders move until you click Resume syncing, and orders placed in the meantime are imported when you resume, up to 30 days back.

To disconnect it, click Disconnect and confirm with Yes, disconnect. Toldo withdraws its access on Mercado Libre, deletes the access tokens and the listing and order links, and stops syncing the account. Your rules are kept in case you connect it again, but orders placed while it was disconnected aren't imported. Your listings on Mercado Libre stay as they are, with the last stock and price sent, and the orders already in Shopify don't change. To also delete the rules and the account's activity, click Remove.

Frequently asked questions

Can I connect more than one Mercado Libre account?

Yes. Each account has its own page and its own rules. Mercado Libre asks you to authorize with the account that's signed in on your browser: to connect another one, sign out of Mercado Libre (or use a private window), sign in with the other account's main user and repeat the steps. Before connecting, Toldo shows you which account you're connecting.

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 whenever you want.

Is Toldo an official Mercado Libre app?

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