Mercado Libre
Move Mercado Libre orders, products and stock to the rest of your business without re-keying.
35 ways to read, 6 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Mercado Libre, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Answer questionApproval by rule
- Create itemApproval by rule
- Get billing summaryRead
Example flow
- Mercado Libre · Get billing summaryDone
- Mercado Libre · Answer questionNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Mercado Libre.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Mercado Libre
- Mercado Libre's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Mercado Libre listings, variations, pictures, prices and promotions; orders, packs, shipments, claims and post-sale messages; questions, billing, reputation, visits and categories.
Mercado Libre API docs- Source actions
- 35
- Destination actions
- 6
- Data types
- 29
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Answers1
- Answer questionDestinationNot retried automaticallyApproval before production
Post the seller's public answer to a buyer question.
Billing documents1
- List billing documentsSource
Invoices and credit notes Mercado Libre issued to the seller for a period.
Billing periods1
- List billing periodsSource
Monthly billing periods (last 12) with totals, unpaid amount and status.
Billing summary1
- Get billing summarySource
Charges, bonuses and totals billed to the seller for a period.
Categories2
- Get categorySource
A category with its path from root, children and listing settings.
- List site categoriesSource
Top-level categories for the connection's site.
Category attributes1
- List category attributesSource
Attributes a category supports, with required flags and allowed values.
Category predictions1
- Predict categorySource
Suggested domains and categories for a product title.
Claim messages1
- List claim messagesSource
Messages exchanged on a claim between buyer, seller and mediator.
Claims2
- Get claimSource
One claim with players, available actions and resolution.
- Search claimsSourceIncremental
Claims (mediations, returns and cancellations) against the seller, by stage, status, order or update date.
Item descriptions2
- Get item descriptionSource
A listing's plain-text description.
- Update item descriptionDestinationProvider duplicate protectionApproval before production
Replace a listing's plain-text description.
Item pictures2
- List item picturesSource
A listing's pictures with IDs, URLs, size and maximum size.
- Replace item picturesDestinationProvider duplicate protectionApproval before production
Set a listing's picture list, in order, from existing picture IDs and/or public HTTPS image URLs. Pictures left out are removed from the listing.
Item prices1
- List item pricesSource
Standard and promotional prices of a listing by channel context.
Item promotions1
- List item promotionsSource
Every promotion an item is in or eligible for, with the price in each.
Item variations3
- Get item variationSource
One variation of a listing.
- List item variationsSource
A listing's variations with attribute combinations, price, stock and pictures.
- Update item variationDestinationProvider duplicate protectionApproval before production
Change one variation's price, stock, SKU or pictures.
Item visits1
- List item visitsSource
Visits to up to 50 listings in a date range.
Items5
- Create itemDestinationNot retried automaticallyApproval before production
Publish a listing with explicit price and stock (title or family name).
- Get itemSource
A listing with price, stock, status, attributes, variations and pictures.
- Get items (multi-get)Source
Full listings for up to 20 item IDs in one call.
- Search seller itemsSource
IDs of the seller's listings by status or SKU.
- Update itemDestinationProvider duplicate protectionApproval before production
Change a listing's title, price, stock, status (active or paused) or attributes.
Messages1
- List post-sale messagesSource
Post-sale conversation with the buyer of a pack (or order without a pack). Messages are not marked as read.
Orders2
- Get orderSource
One order with items, payments and shipment reference.
- Search ordersSourceIncremental
The seller's orders updated since a date, oldest first, optionally by status.
Packs1
- Get pack (cart)Source
A cart (pack) with its orders, shipment and status.
Promotion items1
- List promotion itemsSource
Items in a promotion with their status, promotional price and original price.
Promotions1
- List seller promotionsSource
Campaigns and deals the seller can join or is in, with dates and benefits.
Questions2
- Get questionSource
One buyer question with its answer.
- List buyer questionsSource
Questions on the seller's listings, by status or item.
Reputation1
- Get seller reputationSource
Reputation level, Mercado Líder status, transactions and quality metrics (claims, delays, cancellations).
Sale prices1
- Get sale priceSource
The price a buyer pays now for a listing in a channel and loyalty context.
Shipment history1
- List shipment historySource
Status and substatus changes of a shipment, with dates.
Shipment items1
- List shipment itemsSource
Items in a shipment with quantity, variation, order and package dimensions.
Shipments1
- Get shipmentSource
Shipment status, tracking number, logistics type and receiver address.
User visits1
- Get seller visitsSource
Total visits to all the seller's listings in a date range.
Users1
- Get authorised userSource
The authorised seller's ID, nickname, site and reputation.
Access and limits
- Authentication
- OAuth 2.0 refresh token (single-use, rotated on refresh)
- Plans and access
- Any Mercado Libre seller with a registered application in the DevCenter. The application needs read, write and offline_access permissions; some categories require the User Products model (family_name instead of title).
- Test environment
- Create test users with POST /users/test_user on your application to test listings and orders.
- Rate limits
- Per-application quotas (orders search about 100 requests per minute); HTTP 429 when exceeded. Access tokens last 6 hours.
- Pagination
- offset and limit with paging.total (items search max 100 per page and 1,000 results; orders 51 per page).
- Provider events
- Notifications for orders_v2, items, questions, shipments and payments topics. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- This is the marketplace API; Mercado Pago payments are a separate connector.
- Refresh tokens are single-use: every refresh writes the new token back to the secure vault, and a failed write requires re-authorisation.
- Item search returns IDs only; use Get item or Get items (multi-get, 20 per call) for full details. Results beyond 1,000 need scan mode, which is not implemented.
- Intentionally excluded: closing or deleting listings and variations, cancellations, refunds, claim actions (messages, evidence, disputes), joining or leaving promotions, and sending buyer messages.
- Claims, post-sale messages, promotions, billing and visits are read-only. Reading post-sale messages passes mark_as_read=false so the seller's unread state is unchanged.
- Picture uploads (multipart) are not implemented; Replace item pictures links existing picture IDs or public HTTPS image URLs, and drops pictures left out.
- Promotion item paging uses Mercado Libre's search_after token, which expires after 5 minutes.
- Billing reads default to the ML (Mercado Libre) group; MLM uses the period expiration date as the period key.
- Mercado Libre documents no idempotency key; item creation and answers are not repeated automatically when uncertain.
- Buyer contact details and addresses are masked by Mercado Libre and only available on shipments.
Developer reference
- Create the Mercado Libre credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Mercado Libre, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/mercado-libre and the Connections API.