Create product
POST/v1/sites/:site_id/products
Create a new product in your source site with support for both JSON and file uploads. The product is created immediately (not queued). Supports duplicate detection and automatic restoration of soft-deleted products. Important: Only source sites (is_destination=0) can create products - use GET /sites?is_destination=0 to find your source sites. *
- Large File Upload Workflow:
- For files larger than 10MB or to prevent timeout issues with large files, use this two-step process:
-
- Upload files:
POST /upload-temporary-file(withfiles[]in multipart form-data,group=manual-create-product)
- Upload files:
-
- Create product:
POST /sites/{site_id}/products(use returned file paths inimage_file_paths[],video_file_path,digital_file_paths[])
- Create product:
- This approach prevents timeout issues and allows for better error handling. Files are uploaded to temporary storage first, then moved to permanent storage when the product is created.
Request
Responses
- 200
- 400
- 401
- 404
- 409
- 422
Product created successfully
Validation error or site is not source site
Unauthenticated
Site not found
Product already exists (duplicate SKU)
Validation error - missing required fields or invalid file format