Skip to main content
POST
/
v1
/
imports
/
products
Batch Create Products
curl --request POST \
  --url https://{defaultHost}/v1/imports/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "import": {
    "data": [
      {
        "name": "Test Product",
        "slug": "test-product",
        "prices": [
          {
            "amount": 1000,
            "currency": "usd"
          }
        ],
        "product_medias": [
          {
            "url": "https://example.com/image.jpg"
          }
        ]
      }
    ]
  }
}
'
{
  "id": "a27e8e68-7a76-4952-aa27-8637fd1aa796",
  "object": "import",
  "import_type": "product",
  "live_mode": true,
  "rows_imported": 0,
  "rows_uploaded": 0,
  "status": "pending",
  "created_at": 1767909707,
  "updated_at": 1767909707
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
import_products
object

Response

200 - application/json

Success

​
id
string | null

The UUID of the specific object.

​
object
string

A string describing the object type returned.

​
import_type
string

The type of record imported – one of customer, product, coupon, purchase, or subscription.

​
import_rows
array

A list of associated import rows.

​
rows_imported
integer

The number of rows successfully imported.

​
status
string

The status of the import – one of completed, invalid, pending, or processing.

​
created_at
integer | null

Time at which the object was created. Measured in seconds since the Unix epoch.

​
updated_at
integer | null

Time at which the object was last updated. Measured in seconds since the Unix epoch.