POST
Create Seller Product

Authorizations

x-api-key
string
header
required

Body

application/json
sku
string
required

Your unique code for the product. Cannot be changed later.

name
string
required

Product name.

variant
string

Variant of the product (size, color, flavor...).

category
string

Product category.

brand
string

Product brand.

active
boolean
default:false

Whether the product is active. Defaults to false when omitted.

image
string<uri>

Public URL of the product image. It is imported asynchronously after the product is created.

composite
boolean

Currently not applied by this endpoint (products are always created as non-kit products).

low_stock_notification_threshold
integer

Currently not applied by this endpoint (the stored value is 1).

Required range: x >= 1
inbound_minimum_shelf_life
integer

Minimum remaining shelf life, in days, a unit must have to be received into a Melonn warehouse. Must be greater than or equal to storage_minimum_shelf_life. For perishable products.

Required range: x >= 1
storage_minimum_shelf_life
integer

Minimum remaining shelf life, in days, a unit must keep while stored to remain available for orders. For perishable products.

Required range: x >= 1
min_storage_temp_celcius
integer

Minimum storage temperature, in degrees Celsius.

Required range: x >= 1
max_storage_temp_celcius
integer

Maximum storage temperature, in degrees Celsius.

Required range: x >= 1
allows_cross_contamination
boolean
default:false

Whether the product can be stored next to other products without risk of cross contamination.

buyer_returns_allowed
boolean

Currently not applied by this endpoint (the stored value is true).

control_by_lot_number
boolean

Currently not applied by this endpoint.

control_by_serial_number
boolean

Currently not applied by this endpoint.

expiration_date_format
string

Currently not applied by this endpoint.

fragile
boolean
default:false

Whether the product is fragile.

packing_instructions
string

Currently not applied by this endpoint.

perishable
boolean
default:false

Whether the product is perishable.

pre_packed_order_container
boolean

Currently not applied by this endpoint.

reception_instructions
string

Currently not applied by this endpoint.

requires_health_register
boolean

Currently not applied by this endpoint.

default_buyer_return_item_action_id
enum<string>

What to do with a unit returned by a buyer. In responses it is returned as a number (1 RETURN_STOCK, 2 RETURN_SELLER, 3 DISCARD, 4 DONATE).

Available options:
RETURN_STOCK,
RETURN_SELLER,
DISCARD,
DONATE
restock_failed_inspection_buyer_return_item_action_id
enum<string>

What to do with a returned unit that fails the restock inspection. In responses it is returned as a number (1 RETURN_STOCK, 2 RETURN_SELLER, 3 DISCARD, 4 DONATE).

Available options:
RETURN_STOCK,
RETURN_SELLER,
DISCARD,
DONATE
stackable
boolean

Whether units can be stacked on top of each other.

storage_instructions
string

Currently not applied by this endpoint.

seller_product_barcodes
object[]

Barcodes of the product. Only the first one is registered; all of them must be unused in your account.

seller_product_info_by_country
object

Cost, price and declared value of the product in one country.

Response

The product was created. The body is the created product with its product attributes at the top level.

The created or updated product, with the product attributes at the top level.

seller_id
integer

Your seller id.

active
boolean

Whether the product is active.

composite
boolean | null

Whether the product is a kit made of other products.

sku
string

Your code for the product.

external_barcode
string | null

Main barcode of the product.

source_seller_ecommerce_store_id
integer | null

Sales-channel store the product was imported from, if any.

reception_instructions
string | null
packing_instructions
string | null
creation_date
string<date-time> | null
last_updated_date
string<date-time> | null
buyer_returns_allowed
boolean
default_buyer_return_item_action_id
integer | null

1 RETURN_STOCK, 2 RETURN_SELLER, 3 DISCARD, 4 DONATE.

restock_failed_inspection_buyer_return_item_action_id
integer | null

1 RETURN_STOCK, 2 RETURN_SELLER, 3 DISCARD, 4 DONATE.

buyer_return_restock_inspection_instructions
string | null
low_stock_notification_threshold
integer

Stock level that triggers a low-stock notification.

last_low_stock_notification_date
string<date-time> | null
storage_instructions
string | null
requires_health_register
boolean | null
health_register_document_url
string | null
packing_material_type_id
integer | null
pre_packed_order_container
boolean | null
product_type_id
integer | null

1 = sellable product.

product_category_id
integer | null
product_category
string | null
product_brand_id
integer | null
product_brand
string | null
name
string
description
string | null
variant
string | null
perishable
boolean | null
control_by_lot_number
boolean | null
control_by_serial_number
boolean | null
fragile
boolean | null
net_content
string | null
small_image_url
string | null
medium_image_url
string | null
large_image_url
string | null
stackable
boolean | null
min_storage_temp_celcius
integer | null
max_storage_temp_celcius
integer | null
allows_cross_contamination
boolean | null
flammable
boolean | null
weapon
boolean | null
sat_category_id
integer | null

Mexican SAT product category, if assigned.

lot_number_regex
string | null
serial_number_regex
string | null
expiration_date_format
enum<string> | null
Available options:
DDMMYY,
MMDDYY,
DDMMMYY,
MMMDDYY,
DDMMM,
MMMYYYY,
null
use_state_height
number | null
use_state_length
number | null
use_state_width
number | null
use_state_dimensions_validated
boolean | null
exclude_from_dimensioning
boolean | null
requires_sanitary_registry
boolean | null
inbound_minimum_shelf_life
integer | null

Minimum remaining shelf life (days) to receive a unit.

storage_minimum_shelf_life
integer | null

Minimum remaining shelf life (days) to keep a stored unit available.

product_type
object
seller_product_case_level
object[]

Packaging levels of the product (unit, case...). Returned by Update Seller Product only.