Update products in bulk

PUT

/products/bulk

Updates up to 100 products for the API-key community from a raw JSON array or a CSV file upload.

Each JSON item or CSV product group must include productID. JSON updates may send any subset of editable product fields; CSV updates only apply non-blank cells.

Request

Header Params

Body Params

application/json

Required

Examples

Responses

🟢200OK

application/json

Products updated for the API-key community.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

🔴502Bad Gateway

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.returning.ai/v1/products/bulk' \
--header 'Authorization: Bearer XXXXXX' \
--header 'Content-Type: application/json' \
--data '[
    {
        "productID": "507f1f77bcf86cd799439011",
        "name": "Premium Voucher",
        "price": 120,
        "vouchers": [
            "VOUCHER-003"
        ],
        "voucherExpireDate": "2026-12-31T00:00:00.000Z"
    }
]'

Response Example

200 - Success Example

{
    "meta": {
        "status": "success",
        "statusCode": 200,
        "updated": 1
    },
    "message": "Update products success.",
    "data": [
        {
            "_id": "507f1f77bcf86cd799439011",
            "communityID": "6502c9e514a3e564c5c09c0a",
            "name": "Premium Voucher",
            "description": "<p>Updated premium access reward.</p>",
            "image": "https://example.com/product.png",
            "price": 120,
            "category": "Premium Rewards",
            "stocks": 3,
            "discountPrice": 100,
            "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": "<p>Show this voucher at checkout.</p>",
            "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-11T00:00:00.000Z"
        }
    ]
}

Modified at 2026-06-11 10:15:01

Update product and append vouchers

Delete product