Create products in bulk

Creates up to 100 voucher products for the API-key community and returns the created public product records.

Use this endpoint when a partner integration needs to import many store products at once. Send a raw JSON array for direct server-to-server integrations, or upload a CSV file with multipart form-data for spreadsheet-based operational imports.

Authentication:

Bearer API key in the Authorization header. Example: Bearer XXXXXX.

Required API-key permission: store.

The community is resolved from the API key token; do not pass communityID.

Missing, invalid, expired, or insufficient credentials return 401 or 403.

Request formats:

application/json: raw array of product create objects. Do not wrap the array in an object such as products.

multipart/form-data: CSV upload using the file field.

CSV MIME type must be text/csv, application/csv, or application/vnd.ms-excel.

CSV file size must be 10 MiB or less.

Bulk limits and validation:

Maximum 100 products per request.

Each JSON item follows the same full body contract as POST /products.

categoryName, productPermission, and purchaseStatusOverrideName use readable names resolved inside the API-key community.

vouchers should be an empty array when no vouchers should be created.

voucherExpireDate may be an empty string only when vouchers is empty.

Duplicate voucher codes in the upload, or voucher codes that already exist for the product, can return 409.

Validation errors include malformed JSON arrays, object wrappers, unsupported CSV MIME types, missing CSV file field, invalid CSV rows, invalid DTO fields, and product count limit violations.

CSV rules:

Rows with Name start a new product.

Rows without Name append permission entries to the previous product row.

Continuation rows cannot include scalar product columns such as Price, Category Name, Vouchers, or Voucher Expire Date.

Supported headers are Name, Description, Image, Price, Category Name, Discount Enabled, Discount Price, Discount Start Date, Discount End Date, User Information Enabled, Collect Name, Collect Phone, Collect Address, Prioritize Expiring Vouchers, Display Remaining Quantity, Expiring Highlight Enabled, Expiring Highlight Duration, Expiring Highlight Timeframe, Archived, Redemption Instructions, Product Access Enabled, Purchase Status Override Name, Vouchers, Voucher Expire Date, Permission Enabled, Permission Type, Roles, Tags, Users, Combination Type, Combination Values, Special Price, Special Price Enabled, Purchase Limit Enabled, Purchase Limit Quantity, Purchase Limit Interval Count, Purchase Limit Interval Unit, Access Level, and Exclusive Tag Enabled.

Side effects:

Creates voucher products in the resolved community.

Creates submitted voucher codes when vouchers is not empty.

Publishes PRODUCT_EVENTS.CREATE_PRODUCTS through the partner publisher path.

The store service validates readable references, persists products, creates vouchers, and returns readable category, permission, and purchase-status fields.

Product data becomes available to store read endpoints after the store service persists the bulk operation.

Rate limits:

Standard API rate limits apply.

Related endpoints:

GET /products lists products.

POST /products creates one product.

GET /products/{productID} reads one product.

PUT /products/{productID} updates one product.

PUT /products/bulk updates products in bulk.

DELETE /products/{productID} deletes one product.

curl --location 'https://adss-integration.returning.ai/apis/products/bulk' \ --header 'Authorization: Bearer XXXXXX' \ --header 'Content-Type: application/json' \ --data '[ { "name": "Premium Voucher", "description": "Premium access reward.", "image": "https://example.com/product.png", "price": 100, "categoryName": "Premium Rewards", "discountPrice": 90, "isDiscountEnabled": false, "discountStartDate": null, "discountEndDate": null, "userInformation": { "isEnabled": false, "shouldCollectName": false, "shouldCollectPhone": false, "shouldCollectAddress": false }, "shouldPrioritiesExpiringVouchers": false, "shouldDisplayRemainingQuantity": true, "expiringVoucherHighlight": { "isEnabled": false, "duration": 7, "timeframe": "days" }, "isArchived": false, "redemptionInstructions": "Show this voucher at checkout.", "productPermission": [ { "isEnabled": true, "type": "role", "permission": { "roleNames": [ "VIP Member" ], "tagNames": [ "Early Access" ], "usernames": [ "alex" ], "combination": [ { "type": "role", "values": [ "VIP Member" ] } ] }, "purchaseAccess": { "specialPrice": 80, "isSpecialPriceEnabled": false }, "purchaseLimit": { "isPurchaseLimitEnabled": false, "quantity": 1, "intervalCount": 1, "intervalUnit": "months" }, "accessLevel": "full-access", "isExclusiveTagEnabled": false } ], "isProductAccessEnabled": false, "purchaseStatusOverrideName": null, "vouchers": [ "VOUCHER-001", "VOUCHER-002" ], "voucherExpireDate": "2026-12-31T00:00:00.000Z" } ]'

{ "meta": { "status": "success", "statusCode": 201, "created": 1 }, "message": "Create products success.", "data": [ { "_id": "507f1f77bcf86cd799439011", "communityID": "6502c9e514a3e564c5c09c0a", "name": "Premium Voucher", "description": "Redeem for premium access.", "image": "https://example.com/product.png", "price": 100, "category": "Premium Rewards", "stocks": 2, "discountPrice": 90, "isDiscountEnabled": false, "discountStartDate": null, "discountEndDate": null, "userInformation": { "isEnabled": false, "shouldCollectName": false, "shouldCollectPhone": false, "shouldCollectAddress": false }, "shouldPrioritiesExpiringVouchers": false, "shouldDisplayRemainingQuantity": true, "expiringVoucherHighlight": { "isEnabled": false, "duration": 7, "timeframe": "days" }, "isArchived": false, "totalOrders": 0, "redemptionInstructions": "Show this voucher at checkout.", "productPermission": [ { "isEnabled": true, "type": "role", "permission": { "roleNames": [ "VIP Member" ], "tagNames": [ "Early Access" ], "usernames": [ "alex" ], "combination": [ { "type": "role", "values": [ "VIP Member" ] } ] }, "purchaseAccess": { "specialPrice": 80, "isSpecialPriceEnabled": false }, "purchaseLimit": { "isPurchaseLimitEnabled": false, "quantity": 1, "intervalCount": 1, "intervalUnit": "months" }, "accessLevel": "full-access", "isExclusiveTagEnabled": false } ], "isProductAccessEnabled": false, "purchaseStatusOverride": { "isEnabled": false, "status": null }, "createdAt": "2026-06-09T00:00:00.000Z", "updatedAt": "2026-06-09T00:00:00.000Z" } ] }

Request

Responses