Mercado Libre - Create Item

Description

This module allows publishing products on Mercado Libre with all configuration options: price, stock, images, attributes, and shipping.

Configuration

Credentials

This module requires Mercado Libre (OAuth) credentials with the following fields:

Field	Description
access_token	OAuth access token with write permissions

Parameters

Field	Type	Required	Description
credentials_id	string	Yes	Credentials ID
title	string	Yes	Product title (max 60 chars)
category_id	string	Yes	Category ID (MLA1234)
price	number	Yes	Product price
currency_id	string	No	Currency (default: ARS)
available_quantity	number	No	Available stock (default: 1)
condition	string	No	new, used, not_specified
listing_type_id	string	No	Listing type
description	string	No	Product description
pictures	array	No	Image URLs
seller_custom_field	string	No	SKU or internal code
shipping_mode	string	No	Shipping mode
free_shipping	boolean	No	Free shipping
warranty	string	No	Warranty text
attributes	array	No	Product attributes

Listing Types (listing_type_id)

Value	Description	Commission
gold_special	Classic	Medium
gold_pro	Premium	High
free	Free	No commission

Supported Currencies

Code	Country
ARS	Argentina
MXN	Mexico
BRL	Brazil
CLP	Chile
COP	Colombia
USD	Dollar

Output

{
  "success": true,
  "item": {...},
  "item_id": "MLA123456789",
  "permalink": "https://articulo.mercadolibre.com.ar/...",
  "message": "Item \"iPhone 15 Pro\" created successfully with ID MLA123456789"
}

Usage Example

Basic product

{
  "credentials_id": "meli_cuenta",
  "title": "iPhone 15 Pro Max 256GB Negro",
  "category_id": "MLA1055",
  "price": 1500000,
  "available_quantity": 5
}

Product with images

{
  "credentials_id": "meli_cuenta",
  "title": "Zapatillas Nike Air Max 90",
  "category_id": "MLA1574",
  "price": 89999,
  "condition": "new",
  "pictures": [
    "https://example.com/imagen1.jpg",
    "https://example.com/imagen2.jpg"
  ]
}

Product with attributes

{
  "credentials_id": "meli_cuenta",
  "title": "Samsung Galaxy S24 Ultra 512GB",
  "category_id": "MLA1055",
  "price": 2500000,
  "attributes": [
    {"id": "BRAND", "value_name": "Samsung"},
    {"id": "MODEL", "value_name": "Galaxy S24 Ultra"},
    {"id": "INTERNAL_MEMORY", "value_name": "512 GB"}
  ]
}

Product with free shipping

{
  "credentials_id": "meli_cuenta",
  "title": "Smart TV 55 4K UHD",
  "category_id": "MLA1002",
  "price": 450000,
  "shipping_mode": "me2",
  "free_shipping": true
}

Product with SKU and warranty

{
  "credentials_id": "meli_cuenta",
  "title": "Notebook Lenovo ThinkPad",
  "category_id": "MLA1652",
  "price": 850000,
  "seller_custom_field": "LNV-TP-001",
  "warranty": "12 meses de garantia oficial"
}

Used product

{
  "credentials_id": "meli_cuenta",
  "title": "PlayStation 5 Digital Edition",
  "category_id": "MLA1144",
  "price": 650000,
  "condition": "used",
  "description": "Consola en excelente estado, poco uso. Incluye control original."
}

Example Workflows

Publishing from ERP

[ERP Webhook] -> [Prepare data] -> [MeliCreateItem] -> [Save ID in DB]

Bulk publishing

[Read CSV] -> [Loop] -> [MeliCreateItem] -> [Log results]

Catalog sync

[Schedule] -> [Get new products] -> [MeliCreateItem] -> [Notify]

Usage with ExecuteScript

// Prepare product from external system
const producto = ctx.data.producto_erp;

ctx.data = {
  title: producto.nombre.substring(0, 60), // Max 60 chars
  category_id: producto.categoria_meli,
  price: producto.precio * 1.15, // 15% margin
  available_quantity: producto.stock,
  condition: producto.es_nuevo ? 'new' : 'used',
  seller_custom_field: producto.sku,
  pictures: producto.imagenes,
  attributes: [
    { id: 'BRAND', value_name: producto.marca },
    { id: 'MODEL', value_name: producto.modelo }
  ],
  shipping_mode: 'me2',
  free_shipping: producto.precio > 50000
};

Common Errors

Error	Cause	Solution
”category_id is required”	Missing category	Specify a valid category_id
”Invalid category_id”	Incorrect category	Use the category predictor
”title exceeds max length”	Title too long	Maximum 60 characters
”Invalid picture URL”	Invalid URL	Verify image URLs

API Used

• API: Mercado Libre API
• Endpoint: POST /items
• Documentation: https://developers.mercadolibre.com/

Notes

• The title has a maximum of 60 characters
• Images must be publicly accessible URLs
• The category must be a leaf (no subcategories)
• Attributes vary by category
• Mercado Envios (me2) requires dimensions in some cases

Related Nodes

• MeliGetItems - Get published items
• MeliUpdateItem - Update existing items
• MeliGetOrders - Query item sales