Create product

Use this endpoint to create the base record, not a marketplace offer. It does not call a Connection and does not publish anything. The response contains the Product; in the same transaction the API creates a standard Variant with options: {}, no SKU, and inventoryAuthority: "disabled".

Put only reusable data here: localized content, canonical identity (brand, model, identifiers), typed attributes, physical data (physical: item and package weight in grams and dimensions in millimeters, as integers), fiscal and compliance declarations, media, and your application's metadata. Price, commercial terms, and channel-specific copy belong to a Listing; color, storage, SKU, and GTIN specific to a combination belong to a Variant.

Each attribute states its value type, for example { "key": "material", "value": { "type": "text", "text": "aluminum" } }. Use UCUM units for measurable values, such as g, cm, or V. In physical, weightInGrams and dimensionsInMm describe the item; packageWeightInGrams, packageDimensionsInMm, and packageQuantity describe what ships.

Example decision: create iPhone 16 once as a Product. Then turn its standard Variant into a simple sellable unit or create black/128 GB and white/128 GB Variants. Only then create an offer on Mercado Livre, Amazon, or another channel.

Use Idempotency-Key when retrying a creation after a network failure. Reusing the same key prevents a duplicate Product and standard Variant.

{  "certifications": [],  "warnings": []}