Import products through an import feed

The products specified in the body will be imported via the feed specified in the path.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Specifies the import target. Possible values: master, salsify_v1. Use 'master' to import products to master data.

Query Params
string

language context of import

Body Params

The list of products to import and feed options needed by the specified target.

boolean

Whether or not to run auto-assignment rules when import is completed. These rules are configured in the PDX UI. Default: true

autoSubmitRequest
object

Defines the parameters for performing automatic submissions

string

If importing directly to a channel, the channel ID specifies which channel to import to. If importing to master data, this field is ignored.

products
array of objects

List of products to import Example:

[
    {
        "__ID": "very_large_object",
        "__NAME": "Very Large Object",
        "PRIMARY_IMAGE": "https://example.com/place.jpg",
        "PACKAGING": {
            "target": "very_large_box",
            "metadata": {
                "QUANTITY": 2
            }
        },
        "Size": "Very Large",
        "Color": "Dark",
        "GTIN14": "44247579495125"
    }
]
products
string
enum

How will product imports be executed.

IMPORTER: Regular 'upsert'. Will create products if they don't exist. For existing products only attributes included in the export will be updated, other existing attributes on the product will be untouched.

REPLACEMENT: Creates product that don't exist. For existing products replaces all API defined attributes with exactly what is included in the import. Existing attributes not included in the import will have their values deleted.
Allowed:
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json