Skip to main content
POST
Upload a product catalog

Authorizations

Authorization
string
header
required

Use your account ID as the username and your personal access token (PAT) as the password, or pass a Base64-encoded value directly in the Authorization header. For more information, see the personal access tokens guide.

Body

multipart/form-data
file
file
required

A JSON file containing an array of product objects. The filename must end in .json. Maximum size: 50MB. The file is processed asynchronously — the response includes a job_id for tracking progress with Check import status.

Response

The catalog import job was queued. A 202 response doesn't mean the products passed validation — invalid products are skipped and counted in failed_count on the job status; they aren't rejected at upload time.

job_id
string<uuid>
required

Unique import job identifier. Use it to poll Check import status.