POST

Bulk Add Info Sections To Products


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Adds info sections to multiple products.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Stores - all permissions
Manage Products
Manage v3 catalog
Product write in v3 catalog
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/stores/v3/bulk/products/add-info-sections

Body Params
productsArray <ProductIdWithRevision>RequiredminItems 1maxItems 100

List of product IDs and revisions.


infoSectionIdsArray <string>Requiredformat GUIDminItems 1maxItems 10

List of IDs of info sections to add.


returnEntityboolean

Whether to return the full updated product entities in the response.

Default: false


fieldsArray <string>maxItems 100

Fields to include in the response.

Response Object
resultsArray <BulkProductResult>minItems 1maxItems 100

Products updated by bulk action.


bulkActionMetadataBulkActionMetadata

Bulk action metadata.

Bulk add info sections to products
Request
cURL
curl POST 'https://www.wixapis.com/stores/v3/bulk/products/add-info-sections' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' \ -d '{ "fields": [ ], "infoSectionIds": [ "b9b39003-0edd-41c0-9403-a0fe19cc5bb4", "1dac2b73-3592-4d80-9a6e-4892caf4e058" ], "products": [ { "productId": "d17bb5c4-e10f-4b83-ae97-f27f2edc18f1", "revision": "8" }, { "productId": "abc62281-87b7-47e8-98ba-20e25341ad98", "revision": "5" } ], "returnEntity": true }'
Response
JSON
{ "results": [ { "itemMetadata": { "id": "d17bb5c4-e10f-4b83-ae97-f27f2edc18f1", "originalIndex": 0, "success": true }, "item": { "id": "d17bb5c4-e10f-4b83-ae97-f27f2edc18f1", "revision": "9", "createdDate": "2024-07-22T13:22:47.771Z", "updatedDate": "2024-07-22T16:38:05.649Z", "name": "Premium Coffee", "slug": "coffee", "visible": false, "visibleInPos": false, "media": { "main": { "id": "370e1a_c65292a0c0584c26aa32d9d921302af9~mv2.jpeg", "image": { "id": "370e1a_c65292a0c0584c26aa32d9d921302af9~mv2.jpeg", "url": "https://static.wixstatic.com/media/370e1a_c65292a0c0584c26aa32d9d921302af9~mv2.jpeg", "height": 1200, "width": 1200, "filename": "food.jpeg", "sizeInBytes": "116752" }, "uploadId": "370e1a_c65292a0c0584c26aa32d9d921302af9~mv2.jpeg" }, "items": [ { "id": "370e1a_c65292a0c0584c26aa32d9d921302af9~mv2.jpeg", "image": { "id": "370e1a_c65292a0c0584c26aa32d9d921302af9~mv2.jpeg", "url": "https://static.wixstatic.com/media/370e1a_c65292a0c0584c26aa32d9d921302af9~mv2.jpeg", "height": 1200, "width": 1200, "filename": "food.jpeg", "sizeInBytes": "116752" }, "uploadId": "370e1a_c65292a0c0584c26aa32d9d921302af9~mv2.jpeg" }, { "id": "370e1a_8412ab11b3ad48bb8375a2ecb1cc8b4d~mv2.jpeg", "image": { "id": "370e1a_8412ab11b3ad48bb8375a2ecb1cc8b4d~mv2.jpeg", "url": "https://static.wixstatic.com/media/370e1a_8412ab11b3ad48bb8375a2ecb1cc8b4d~mv2.jpeg", "height": 1200, "width": 1200, "filename": "food.jpeg", "sizeInBytes": "116752" }, "uploadId": "44682905-395a-4c18-8fab-e050725ba3f6" } ] }, "options": [ { "id": "85bb0544-63c7-431b-9659-f81b18a7dd9f", "name": "Size", "optionRenderType": "TEXT_CHOICES", "choicesSettings": { "choices": [ { "choiceId": "4498b805-2aed-43fb-b478-989c906c19cd", "linkedMedia": [], "choiceType": "CHOICE_TEXT", "key": "S", "name": "S", "inStock": true }, { "choiceId": "26394ab0-d81a-422f-a8c9-562f49a6b595", "linkedMedia": [], "choiceType": "CHOICE_TEXT", "key": "L", "name": "L", "inStock": false } ] }, "key": "Size" }, { "id": "1938d364-126d-4304-b706-9e9e9f6d376f", "name": "Box color", "optionRenderType": "SWATCH_CHOICES", "choicesSettings": { "choices": [ { "choiceId": "2e98f13b-ae65-4d30-96c5-ac3a6cf99d60", "linkedMedia": [], "choiceType": "ONE_COLOR", "key": "red", "name": "red", "colorCode": "#FF0000", "inStock": true }, { "choiceId": "4876dcc7-817e-4c10-a6b2-4a4cc2e241e6", "linkedMedia": [], "choiceType": "ONE_COLOR", "key": "blue", "name": "blue", "colorCode": "#0000FF", "inStock": false } ] }, "key": "Box color" } ], "modifiers": [ { "id": "a3d249f0-a8da-425d-9ec1-3c51c795d927", "name": "Remove price tag", "modifierRenderType": "TEXT_CHOICES", "mandatory": false, "choicesSettings": { "choices": [ { "choiceId": "3050481e-e177-4031-bbe9-be9b00af14b5", "linkedMedia": [], "choiceType": "CHOICE_TEXT", "key": "yes", "name": "yes" }, { "choiceId": "ee729b74-d500-4594-aae5-b5a2e75bf5e7", "linkedMedia": [], "choiceType": "CHOICE_TEXT", "key": "no", "name": "no" } ] }, "key": "Remove price tag" } ], "brand": { "id": "4a16d28d-1736-41f0-87d8-995f6d9a5bdd", "name": "EcoCoffee" }, "infoSections": [ { "id": "1dac2b73-3592-4d80-9a6e-4892caf4e058" }, { "id": "59954f23-fbcd-42e5-ba61-7c8cf9d8b409" }, { "id": "b9b39003-0edd-41c0-9403-a0fe19cc5bb4" } ], "ribbon": { "id": "14585597-3302-4145-8da3-24a26d8346d6", "name": "New arrival" }, "mainCategoryId": "643721c3-446e-47f3-87ee-0a58d6842d48", "compareAtPriceRange": { "minValue": { "amount": "6" }, "maxValue": { "amount": "6" } }, "actualPriceRange": { "minValue": { "amount": "5" }, "maxValue": { "amount": "5" } }, "inventory": { "availabilityStatus": "OUT_OF_STOCK", "preorderAvailability": "NO_VARIANTS", "preorderStatus": "DISABLED" }, "productType": "PHYSICAL", "physicalProperties": { "pricePerUnit": { "quantity": 1.0, "measurementUnit": "KG" }, "shippingWeightRange": { "minValue": 0.1, "maxValue": 0.1 } }, "flattenOptions": [], "flattenModifiers": [] } }, { "itemMetadata": { "id": "abc62281-87b7-47e8-98ba-20e25341ad98", "originalIndex": 1, "success": true }, "item": { "id": "abc62281-87b7-47e8-98ba-20e25341ad98", "revision": "6", "createdDate": "2024-07-22T14:04:05.787Z", "updatedDate": "2024-07-22T16:38:05.649Z", "name": "Recyclable Shopping bag", "slug": "shopping-bag", "visible": true, "visibleInPos": true, "media": { "items": [] }, "options": [], "modifiers": [], "infoSections": [ { "id": "1dac2b73-3592-4d80-9a6e-4892caf4e058" }, { "id": "b9b39003-0edd-41c0-9403-a0fe19cc5bb4" } ], "mainCategoryId": "643721c3-446e-47f3-87ee-0a58d6842d48", "compareAtPriceRange": { "minValue": { "amount": "0.5" }, "maxValue": { "amount": "0.5" } }, "actualPriceRange": { "minValue": { "amount": "0.5" }, "maxValue": { "amount": "0.5" } }, "inventory": { "availabilityStatus": "OUT_OF_STOCK", "preorderAvailability": "NO_VARIANTS", "preorderStatus": "DISABLED" }, "productType": "PHYSICAL", "physicalProperties": {}, "flattenOptions": [], "flattenModifiers": [] } } ], "bulkActionMetadata": { "totalSuccesses": 2, "totalFailures": 0, "undetailedFailures": 0 } }
Errors
428Failed Precondition

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?