Está viendo la documentación de la API v1 (versión anterior). v1 sigue funcionando sin cambios hasta el 31 de enero de 2027, fecha en la que se apagará. Las integraciones nuevas deben usar la API v2, que cubre todo lo de v1 con nombres limpios y paginación por cursor. Si ya integró con v1, la guía de migración lista las equivalencias campo por campo.

Recursos

Publicar productos

El endpoint principal. Crea un job asíncrono que la API procesa en segundo plano. Cada job puede tener hasta 10.000 items.

Crear un job de publicación

POST/v1/products

Probar en sandbox

scopeproducts:writeidempotent

Por cada item indica el SKU y la categoría — o le pide a Automeli que la infiera con auto_categorize: true. Ambas opciones son excluyentes.

RequestPOST /products

curl -X POST "https://api.automeli.com/api/v1/products" \
     -H "X-API-Key: automeli_live_..." \
     -H "Content-Type: application/json" \
     -d '{
  "items": [
    { "sku": "B003H03SDQ", "category_id": "MCO420674" },
    { "sku": "B07JHNJLYH", "auto_categorize": true }
  ],
  "listing_type_id": "gold_pro",
  "tax_category_id": 0
}'

202Response

Job aceptado y encolado. Devuelve el job_id para hacer seguimiento.

{
  "job_id": "8a3f2b10-4c9d-4e21-9f8a-1b2c3d4e5f60",
  "status": "queued",
  "accepted": 2,
  "rejected": 0,
  "total_items": 2
}

El modo de prueba lo decide el environment de su API Key, no el body. Si su key es automeli_test_* el job no consume créditos.

Campos del body

items

array (1-10.000)requerido

Cada item: sku + (category_id o auto_categorize).

items[].sku

stringrequerido

10 caracteres alfanuméricos (ASIN de Amazon).

items[].category_id

stringcondicional

ID de Mercado Libre, formato MCO420674. Excluyente con auto_categorize.

items[].auto_categorize

booleancondicional

Automeli infiere la categoría desde el ASIN. Excluyente con category_id.

listing_type_id

stringopcional

Tipo de publicación de Mercado Libre. Default: el configurado por el seller. Valores aceptados: gold_pro (premium con cuotas), gold_special (clásica), más legacy gold_premium / gold / silver / bronze aceptados por compatibilidad. ¿Cuál elijo? →

tax_category_id

intopcional

Índice (no nombre) de la categoría arancelaria del seller. Default 0 (primera). Para ver los índices → GET /v1/account/tax-categories.

scheduled_for

stringopcional

Programa la publicación a una hora futura. Formato YYYY-MM-DDTHH:MM en UTC, sin segundos ni offset. Entre 5 minutos y 30 días en el futuro. Ver guía de programación →

Errores posibles de este endpoint (13)

E_AUTH_MISSING_KEY

Falta el header X-API-Key

401

E_AUTH_INVALID_KEY

Key con formato inválido o no reconocida

401

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_RATE_LIMITED

Excedió el rate limit. Ver Retry-After

429

E_IDEMPOTENCY_CONFLICT

Misma Idempotency-Key con body distinto

409

E_PRODUCT_INVALID_BODY

Body o query malformado (campo, fecha o estado inválido)

422

E_PRODUCT_INVALID_SKU

SKU no cumple regex (10 alfanum)

422

E_PRODUCT_CREDIT_EXHAUSTED

Sin créditos disponibles

400

E_PRODUCT_MAX_CONCURRENT_JOBS

Ya tiene 6 jobs activos

429

E_CATEGORY_INVALID

La categoría de Mercado Libre no cumple el formato (MCO…)

422

E_CATEGORY_AND_AUTO_CONFLICT

Un item manda la categoría y auto_categorize a la vez

422

E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404

E_INTERNAL

Error inesperado. Reintente con backoff

503

Guías relacionadas

Programar publicaciones (UTC) →

El campo scheduled_for: formato estricto, formatos rechazados y conversión de hora local a UTC.

Idempotencia →

Evite jobs duplicados al reintentar requests con el header Idempotency-Key.