Mapaprop ↔ MercadoLibre Integration — Guide for Customers

What can you do with this integration?

Connecting your MercadoLibre account to Mapaprop lets you:

1. Publish your listings on MercadoLibre directly from Mapaprop, without re-entering the data.
2. Receive questions and inquiries from interested parties on MercadoLibre in your Mapaprop inbox, alongside messages from your other channels (website, network, etc.).
3. Answer public ML questions from Mapaprop — the answer is automatically published on your MercadoLibre listing.
4. Contact directly the interested parties who use MercadoLibre's WhatsApp, call, or visit buttons.
5. See the visits your listings receive in Mapaprop's Visits Report, alongside visits from your other channels (website, portals, MLS network). Visits are synced once a day. Visual category: MercadoLibre (orange).

1. Connect your MercadoLibre account

Prerequisites

• Mapaprop Plus subscription or higher (Pro / Business). The MercadoLibre integration is a premium feature.
• A "Real Estate Agency" type MercadoLibre account. Regular personal accounts cannot publish real estate listings. If your account is a regular one, you'll need to convert it first. See the official conversion guide.

Steps to connect

1. Inside Mapaprop, go to Settings → Connected Accounts → MercadoLibre.
2. Click Connect.
3. The MercadoLibre site will open in your browser. Log in with your real estate agency account.
4. Authorize the permissions Mapaprop needs (publish, receive messages, query properties).
5. You'll be redirected back to Mapaprop, where you'll see the Connected status along with your available publication plans.

Keeping the connection alive

• The connection token with MercadoLibre renews automatically every few hours, with no action needed on your part.
• If for some reason the token expires and can't be renewed, you'll see a "Reconnect account" notice on the MercadoLibre page. One click and you're done.
• Only users with the admin or manager role can connect or disconnect the account.

📖 Full setup guide

2. Publish a property on MercadoLibre

Prerequisites to publish

A property can only be published on ML if:

• Your MercadoLibre account is connected and active (no expired token).
• You have an available publication plan (Free, Silver, Gold, Premium Gold, etc.). Plans are purchased on MercadoLibre.
• The property is published on Mapaprop (not a draft).
• The property has the minimum data required by MercadoLibre for its category (valid price, location, title, description, images, mandatory attributes).

Steps to publish

1. Go to Properties → your property → Publication.
2. In the Publish on Networks → MercadoLibre section, click Publish.
3. The ML publication editor will open with a wizard that guides you through:
   • Step 1 — Title and Plan: choose the title (max. 60 characters, no contact details), and the plan you want to use (plans with available quota are highlighted).
   • Step 2 — Category and Location: Mapaprop automatically maps your operation (sale/rental) and property type to the corresponding ML category. The location is also mapped from Mapaprop's data. If your property's zone was never published on MercadoLibre before, you'll see the "Zone not mapped" message with a Map Zone button — clicking it opens a dialog where you choose the MercadoLibre Province, City, and Neighborhood that correspond to your zone. This is done only once per zone and stays configured for all properties in that same location.
   • Step 3 — Attributes: fill in the mandatory and optional attributes (bedrooms, rooms, orientation, amenities, etc.). Mapaprop pre-fills what you already have on your property.
   • Step 4 — Review and Publish: review everything and click Publish.
4. MercadoLibre can take anywhere from a few seconds to several minutes to activate the listing. During that time you'll see the "In process" status.

Possible statuses for your listing

"In process" sub-statuses

While the listing is In process, MercadoLibre tells us why it hasn't activated yet:

⚠️ If your listing stays in this status too long without moving to Active, ML eventually closes it on its own and it shows up as Finished. This usually means the plan is saturated and you need more quota or a plan change.

Available actions by status

Detail of each action:

• View listing: opens the public ML listing in a new tab.
• Edit: modify description, price, attributes, etc. Some fields are locked depending on the status (see the matrix below).
• Pause / Activate: hide or reactivate the listing without losing its record or accumulated visits.
• Finish: close the listing on ML. You can also Finish and delete to remove it completely.
• Republish (green ↻ button, only when Finished): creates a new listing on MercadoLibre linked to the closed one, transferring visits and sales if it was closed less than 60 days ago. See section 2.5.
• Delete from MercadoLibre (trash button): deletes the listing from ML but keeps your data in Mapaprop so you can publish it again later.
• Update Status: asks MercadoLibre for the listing's current status and updates the information in Mapaprop. Useful when the listing is "In process" to check whether it's already active.
• Complete payment: only shows up in the "Requires payment" status. Opens the payment page on MercadoLibre to purchase the pack for the chosen plan.

What can be modified in each status?

Fields marked as Sync update automatically when you edit the property in Mapaprop (price, description, photos, bedrooms, rooms, etc.). Everything else requires opening the MercadoLibre editor and saving.

2.5 Republish a finished listing

When a listing is in Finished status, you can publish it again without losing its history using the Republish button (green ↻ icon) that appears on the MercadoLibre card in the publication panel.

What does it actually do?

Mapaprop uses MercadoLibre's official /items/{id}/relist endpoint, which creates a new listing linked to the closed one through a parent_item_id identifier. It's not a copy or a duplicate: ML recognizes the link and, under certain conditions, transfers the stats.

Benefits of republishing (vs. publishing a new one from scratch)

• ✅ Transfer of visits and sales if the original listing was closed less than 60 days ago. This doesn't apply to the Free plan.
• ✅ Formal link between the new listing and the previous one (better for your ML account's reputation).
• ✅ Lets you change the plan when republishing (for example, moving from Free to Silver if you now have a contracted pack, or from Silver to Free if you want to save).
• ✅ Reuses all the data from the original listing (attributes, location, category, description, photos).

Limitations

• ❌ More than 60 days have passed: the Republish button still works, but ML no longer transfers visits or sales (it starts with stats at zero).
• ❌ You want to change the title or category: this can't be done via Republish. You have to Delete and then Publish from scratch as a new listing.

How to change the plan when republishing

1. Go to the MercadoLibre card and click the Edit button (pencil).
2. Scroll down to the Title and Plan section of the editor.
3. In the Publication plan dropdown, choose the desired plan.
4. Click Save (this persists the plan change in Mapaprop).
5. Click the card's Republish button (green ↻).
6. Mapaprop sends the relist request to MercadoLibre with the new plan. Your listing is created with the chosen plan.

💡 If you choose a paid plan (Silver, Gold) and don't have a contracted pack on MercadoLibre, the listing will end up in Requires payment status. Complete the payment on ML to activate it, or switch to the Free plan.

Important MercadoLibre rules

• Don't include contact details (phone, email, WhatsApp) in the title or description. MercadoLibre may block the listing.
• The price must fall within the ranges allowed for each category. If it's above or below that range, Mapaprop shows you the error message with the exact limit.
• Photos must be real photos of the property, without watermarks or contact details overlaid.
• The category is chosen by MercadoLibre based on your property's data — if the category isn't correct, check that the property type and the operation are set correctly in Mapaprop.

If the publication fails

Mapaprop will show you:

• A friendly suggestion at the top when the error is self-solvable (e.g.: "According to MercadoLibre, the price is invalid for this category. The maximum allowed is X").
• MercadoLibre's technical message below, in case you need to report it to support.
• A "Copy Report" button so you can paste it into a support ticket if the problem persists.

Common errors and how to solve them

2.7 Edit a property published on MercadoLibre

When you go in to edit a property that's already published on MercadoLibre (from Edit property, Prices, Images, Videos, or Floor plans), Mapaprop shows you an informational banner above the form that tells you:

• What status the listing is in on MercadoLibre (Active / Paused / Finished / Requires payment / In process / etc.) with the status color.
• Which fields will NOT be synced when saving — chips with a 🔒 icon indicating the fields locked by MercadoLibre's rules.

Example

If your listing is Active, the green banner says:

✓ Published on MercadoLibre — Active Changes will sync automatically with the published listing. MercadoLibre does NOT allow modifying title, zone, category, or plan on active listings: those fields won't be reflected on ML.

⚠ ATTENTION! Not synced: 🔒 Title · 🔒 Zone · 🔒 Category · 🔒 Plan

Why this banner matters

Before it existed, customers would edit a property's title expecting it to update on ML — but ML silently rejects that change on active listings. The banner warns you before you edit which fields won't travel to the portal, so you know what to expect.

Statuses and behavior

3. Receiving messages from MercadoLibre

When someone interested inquires about one of your listings on MercadoLibre, their message automatically shows up in your Mapaprop inbox (main Inbox tab).

Types of inquiries you can receive

MercadoLibre offers different ways for interested parties to make contact. In your inbox, each inquiry shows up with a badge indicating the type:

How to identify MercadoLibre messages

In the inbox list, ML messages have a yellow "MercadoLibre" tag, alongside the inquiry type badge. This makes it easy to tell them apart from messages from your website, portal network, etc.

Interested party data

Each message includes the data MercadoLibre shares with you:

• Name
• Email
• Phone
• Document (if the interested party provided it)

This data is automatically saved as a contact in Mapaprop. You can use it for follow-up or add it to campaigns.

4. Answer a public question on MercadoLibre

MercadoLibre questions are public on your listing and have special rules that are worth knowing before replying.

MercadoLibre's rules for answers

1. You can only send ONE answer per question. It can't be edited or a second answer added.
2. The answer is public and stays visible on the listing for all buyers.
3. Don't include contact details (phone, email, WhatsApp) in the answer. MercadoLibre may block it.
4. Reply fast. MercadoLibre measures your average response time and uses it as part of your seller reputation. Late answers or unanswered questions lower your ranking.
5. Maximum 2000 characters per answer.

How to answer from Mapaprop

1. Go to the inbox and click the question you want to answer.
2. You'll see the question's text along with:
   • An informational panel with MercadoLibre's rules (a reminder of what can't be done).
   • A text box to write your answer, with a 2000-character counter.
3. Write your answer and click the yellow send button.
4. Mapaprop will ask you for confirmation (it's the only public answer — we want to make sure).
5. Once confirmed, the answer is published immediately on MercadoLibre and shown in the conversation with the "Published on ML" badge.

If you already answered from the MercadoLibre panel

If you'd rather answer directly from the MercadoLibre app or web panel:

• Mapaprop detects it automatically and syncs the answer into your inbox (takes between a few seconds and 1-2 minutes).
• The conversation shows the answer with the "Answered on ML" badge (distinguishable from the previous case).
• There's no conflict or duplication — there's always a single public answer on ML.

What if I try to answer from Mapaprop something already answered on ML?

Mapaprop detects the case and automatically syncs the existing answer. It shows you a notice: "Already answered from MercadoLibre. The existing answer was synced." Nothing new gets published, nothing gets duplicated.

After the answer

Once the question has been answered (from wherever):

• The public answer button disappears.
• A new text box (green) appears, letting you continue the conversation with the interested party via private email from Mapaprop.
• Follow-up messages are NOT published on MercadoLibre — they're private seller ↔ interested-party communication via email.

5. Contact directly via WhatsApp, call, or email

For inquiries that aren't questions (WhatsApp, call, visit, quote), Mapaprop shows direct action buttons inside the interested party's message:

• Open WhatsApp → opens WhatsApp Web/App with a pre-written message ready to send.
• Call → uses your phone's or computer's dialer to call directly.
• Send email → opens your email client with a pre-filled subject (e.g., "Visit scheduling", "Quote requested").

These contacts don't require a public reply on ML — the interested party explicitly asked to be contacted through that channel.

6. Reputation on MercadoLibre — why replying fast matters

MercadoLibre evaluates your seller profile based on:

• Average response time to questions.
• Percentage of questions answered (leaving questions unanswered counts against you).
• Quality of the answers (detailed answers > generic answers).

A good reputation positions you better in search results and generates more inquiries.

Mapaprop helps you maintain a good reputation:

• Messages reach your inbox in near real time (seconds to a few minutes).
• You can answer from your phone, tablet, or computer without opening MercadoLibre.
• If you answer from the ML panel directly, Mapaprop syncs it anyway — no friction.

7. Frequently asked questions

Can I have more than one MercadoLibre account connected? No. Each Mapaprop customer can only connect ONE MercadoLibre account. If you want to switch accounts, first disconnect the current one and then connect the new one.

What happens if a vendor / user on my team wants to publish but isn't an admin? They can publish properties on ML normally, but connecting/disconnecting the MercadoLibre account can only be done by the admin. What happens if I change the price or the property's data on Mapaprop? Mapaprop automatically syncs the changes with MercadoLibre when you edit the property from Edit property, Prices, Images, Map, or Floor plans. You don't need to do anything manually. The fields that sync automatically are: price, description, photos (up to 30), coordinates, video, and mapped numeric/boolean attributes (bedrooms, rooms, area, amenities). When you save, you'll see a toast with the real outcome:

• 🟢 "MercadoLibre — Listing synced" (green) if the listing is active and ML accepted the changes.
• 🟡 "MercadoLibre — Pending changes" (yellow) if the changes were saved in Mapaprop but not sent to the portal (for example: paused, finished, awaiting payment, in process, under review listing). The toast's detail tells you why.
• 🔴 "MercadoLibre — Sync error" (red) if ML rejected the update for some technical reason.

Which changes are NOT synced automatically with MercadoLibre? MercadoLibre imposes restrictions for active or paused listings: it does NOT allow modifying title, zone/location, category, or plan. If you change the property's title on Mapaprop while the ML listing is active, Mapaprop shows you an informational toast: the preventive banner above the form (which appears as soon as you start editing) — with an ATTENTION! Not synced: Title · Zone · Category · Plan notice. Description, price, photos, and attributes do update correctly. To change the title or category you need to finish the listing, delete it from MercadoLibre, and publish it again from scratch.

Can I schedule automatic publications? Not yet. Currently every publication is activated manually with the Publish button. Automatic scheduling is on the roadmap.

What happens if a buyer asks the same question twice? MercadoLibre shows them as separate questions (each with its own ID). You'll see both in your inbox. Answer them individually.

Is the interested party's contact data real? Yes. MercadoLibre shares the buyer's real data with you (name, email, phone). It's data verified by ML.

Does Mapaprop publish my data or my real estate agency's data on MercadoLibre? In the public listing, only your agency's name and the property's data appear. Your/the agent's personal data stays internal to MercadoLibre so buyers can contact you through the enabled channels (question, WhatsApp, call, etc.).

What happens if MercadoLibre blocks my listing? The most common cause is that the title, description, or photos included contact details or something that violates the policies. Check the error message in Mapaprop, fix the listing, and publish again. If the block persists with no apparent reason, contact MercadoLibre support.

Why do many of my listings stay in "In process" status and never activate? The most common cause is that the plan you chose has no available quota (pack_quota_pending). Each MercadoLibre plan (Free, Silver, Gold) has a limited quota of simultaneous listings. If you published more listings than the plan allows, the extra ones stay waiting. Solutions: buy more pack on MercadoLibre, switch to a higher plan, or finish old listings to free up quota. See the specific FAQ on "In process" listings.

What do I do if the listing says "Requires payment"? It means you chose a paid plan (Silver or Gold) but don't have a contracted pack on your MercadoLibre account. You have two options: click Complete payment from Mapaprop to contract the pack on ML, or cancel the listing and republish with the Free plan. See the specific FAQ on "Requires payment".

Can I change the plan of an already finished listing? Yes. When the listing is in Finished status, you can change the plan in the MercadoLibre editor, save, and then click the Republish button (green ↻). The new listing will be published with the chosen plan. This isn't possible while the listing is active. See the specific FAQ on changing the plan on a finished listing.

How long does it take for a listing to activate after publishing? It depends on the plan and the account's status. With available quota and healthy photos, listings activate in seconds to a few minutes. If the plan has no quota or the photos take a while to download, it can take hours or get stuck until the problem is resolved. Use the Update Status button to check the current status.

What does "Images downloading" mean? MercadoLibre tries to download the photos from the Mapaprop server to include them in the listing. If for some reason it can't download them (network slowness, blocked IP, etc.), the listing stays in this sub-status and doesn't activate. It usually resolves itself within a few minutes. If it persists for more than 1 hour, report it to support.

What happens to the visits and sales if I republish a finished listing? If you republish within 60 days of it being closed, MercadoLibre transfers the visits and sales to the new listing (except on the Free plan). After 60 days, you can still republish, but the stats start from zero.

Can I import my current ML listings into Mapaprop? This feature is in planning and will be coming soon. For now, existing listings on ML remain managed from the MercadoLibre panel until you publish them from Mapaprop.

Support

If you're having issues with the integration:

1. Read the detailed setup guide: Notion - MercadoLibre Setup.
2. Convert your account to a real estate agency: Notion - Convert account.
3. Report a technical issue: open a ticket from the Settings → Report an issue section.
4. Issues with your MercadoLibre account (billing, quotas, blocks): contact MercadoLibre's official support directly.

Other MercadoLibre help articles

Publishing on MercadoLibre

Converting your MercadoLibre account to a Real Estate Agency

MercadoLibre Setup

Reconnecting your MercadoLibre account