Create products

POST

https://app.sellerassistant.app/api/v1/sa/inventory/products

The body is one product or an array of them.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/jsonRequired

Example

{
    "title": "My internal product",
    "image_url": "https://example.com/image.jpg",
    "brand": "Catan",
    "package_quantity": 2,
    "default_supplier_id": 1,
    "matches": [
        {
            "platform": "amazon",
            "marketplace_code": "ATVPDKIKX0DER",
            "identifier": "B00U26V4VQ",
            "identifier_type": "asin",
            "title": "External Product Title"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app.sellerassistant.app/api/v1/sa/inventory/products?api_key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{
    "title": "My internal product",
    "image_url": "https://example.com/image.jpg",
    "brand": "Catan",
    "package_quantity": 2,
    "default_supplier_id": 1,
    "matches": [
        {
            "platform": "amazon",
            "marketplace_code": "ATVPDKIKX0DER",
            "identifier": "B00U26V4VQ",
            "identifier_type": "asin",
            "title": "External Product Title"
        }
    ]
}'

Responses

🟢200

application/json

One result for each element. An array answers this shape.

Bodyapplication/json

Example

{
    "data": [
        {
            "id": "P-5XK1S0NQNO",
            "title": "Catan Board Game",
            "brand": "Catan",
            "image_url": "https://m.media-amazon.com/images/I/51N-u8AsmdL.jpg",
            "package_quantity": 2,
            "default_supplier_id": 10,
            "total_stock": 12,
            "tags": [
                3
            ],
            "matches": [
                {
                    "platform": "amazon",
                    "marketplace_code": "ATVPDKIKX0DER",
                    "identifier": "B00U26V4VQ",
                    "identifier_type": "asin",
                    "title": "External Product Title"
                }
            ],
            "created_at": "2026-05-16T15:09:58Z",
            "updated_at": "2026-05-16T15:09:58Z"
        }
    ],
    "meta": {
        "succeeded": 2,
        "failed": 1
    },
    "errors": [
        {
            "code": "not_found",
            "message": "The product [P-1] was not found."
        }
    ]
}

🟢201BadRequest

🟠400BadRequest

🟠402PaymentRequired

🟠403AccessDenied

🟠422BusinessLogicError

🟠429TooManyRequests

Modified at 2026-10-09 12:48:23

List products

Delete products