> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # BulkCreateSections # Package: menus # Namespace: RestaurantsMenusSection # Method link: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/sections/bulk-create-sections.md ## Permission Scopes: Manage Restaurants - all permissions: SCOPE.RESTAURANTS.MEGA-SCOPES ## Introduction > **Note:** The Section API only works with the Wix Restaurants Menus app. Make sure you have installed this app from the [Wix App Market](https://www.wix.com/app-market/wix-restaurants-menus-new). Creates multiple sections at once. --- ## REST API ### Schema ``` Method: bulkCreateSections Description: > **Note:** The Section API only works with the Wix Restaurants Menus app. Make sure you have installed this app from the [Wix App Market](https://www.wix.com/app-market/wix-restaurants-menus-new). Creates multiple sections at once. URL: https://www.wixapis.com/restaurants/menus/v1/bulk/sections/create Method: POST # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: sections Method parameters: param name: returnEntity | type: returnEntity | description: Whether to receive the created sections in the response. param name: sections | type: array | description: Sections details. | required: true - name: name | type: string | description: Section name. - name: description | type: string | description: Section description. - name: image | type: Image | description: Main section image. - name: id | type: string | description: WixMedia image GUID. - name: url | type: string | description: Image URL. - name: height | type: integer | description: Original image height. - name: width | type: integer | description: Original image width. - name: altText | type: string | description: Image alt text. - name: filename | type: string | description: Image filename. - name: additionalImages | type: array | description: Additional section images. - name: itemIds | type: array | description: Item GUIDs. - name: extendedFields | type: ExtendedFields | description: Extended fields. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). - name: visible | type: boolean | description: Whether the section is visible in the menu for site visitors. Return type: BulkCreateSectionsResponse - name: results | type: array | description: Information about the created sections. - name: itemMetadata | type: ItemMetadata | description: Metadata for created sections. - name: id | type: string | description: Item GUID. Should always be available, unless it's impossible (for example, when failing to create an item). - name: originalIndex | type: integer | description: Index of the item within the request array. Allows for correlation between request and response items. - name: success | type: boolean | description: Whether the requested action was successful for this item. When `false`, the `error` field is populated. - name: error | type: ApplicationError | description: Details about the error in case of failure. - name: code | type: string | description: Error code. - name: description | type: string | description: Description of the error. - name: data | type: object | description: Data related to the error. - name: item | type: Section | description: Created section. Only returned if `returnEntity` is set to `true`. - name: id | type: string | description: Section GUID. - name: revision | type: string | description: Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current revision must be passed when updating the section. Ignored when creating a section. - name: createdDate | type: string | description: Date and time the section was created. - name: updatedDate | type: string | description: Date and time the section was updated. - name: name | type: string | description: Section name. - name: description | type: string | description: Section description. - name: image | type: Image | description: Main section image. - name: id | type: string | description: WixMedia image GUID. - name: url | type: string | description: Image URL. - name: height | type: integer | description: Original image height. - name: width | type: integer | description: Original image width. - name: altText | type: string | description: Image alt text. - name: filename | type: string | description: Image filename. - name: additionalImages | type: array | description: Additional section images. - name: itemIds | type: array | description: Item GUIDs. - name: extendedFields | type: ExtendedFields | description: Extended fields. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). - name: visible | type: boolean | description: Whether the section is visible in the menu for site visitors. - name: businessLocationId | type: string | description: GUID of the business location ([SDK](https://dev.wix.com/docs/sdk/backend-modules/restaurants/wix-restaurants-new/about-business-locations.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/restaurants/wix-restaurants-new/about-business-locations.md)) where this section is available. - name: bulkActionMetadata | type: BulkActionMetadata | description: Metadata for the API call. - name: totalSuccesses | type: integer | description: Number of items that were successfully processed. - name: totalFailures | type: integer | description: Number of items that couldn't be processed. - name: undetailedFailures | type: integer | description: Number of failures without details because detailed failure threshold was exceeded. ``` ### Examples ### Create multiple sections ```curl curl -X POST \ 'https://www.wixapis.com/restaurants/menus-section/v1/bulk/sections/create' \ -H 'Authorization: ' \ --data-binary '{ "sections": [ { "itemIds": [ "b3dfd67a-7c77-43e8-a707-38eb53850d4a", "b8e179cc-f339-4ccb-afa9-d9e04d56c461", "cbbf4358-292c-4e9e-a820-7e73b4c4ac00" ], "additionalImages": [], "name": "Mains", "description": "A diverse range of flavorful dishes which are all sourced daily and locally" }, { "additionalImages": [], "name": "Appetizers", "description": "These dishes are great for sharing", "itemIds": [] } ], "returnEntity": true }' ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.menus.RestaurantsMenusSection.bulkCreateSections(sections, options) Description: > **Note:** The Section API only works with the Wix Restaurants Menus app. Make sure you have installed this app from the [Wix App Market](https://www.wix.com/app-market/wix-restaurants-menus-new). Creates multiple sections at once. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: sections Method parameters: param name: options | type: BulkCreateSectionsOptions none - name: returnEntity | type: boolean | description: Whether to receive the created sections in the response. param name: sections | type: array | description: Sections details. | required: true - name: name | type: string | description: Section name. - name: description | type: string | description: Section description. - name: image | type: string | description: Main section image. - name: additionalImages | type: array | description: Additional section images. - name: itemIds | type: array | description: Item GUIDs. - name: extendedFields | type: ExtendedFields | description: Extended fields. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). - name: visible | type: boolean | description: Whether the section is visible in the menu for site visitors. Return type: PROMISE - name: results | type: array | description: Information about the created sections. - name: itemMetadata | type: ItemMetadata | description: Metadata for created sections. - name: _id | type: string | description: Item GUID. Should always be available, unless it's impossible (for example, when failing to create an item). - name: originalIndex | type: integer | description: Index of the item within the request array. Allows for correlation between request and response items. - name: success | type: boolean | description: Whether the requested action was successful for this item. When `false`, the `error` field is populated. - name: error | type: ApplicationError | description: Details about the error in case of failure. - name: code | type: string | description: Error code. - name: description | type: string | description: Description of the error. - name: data | type: object | description: Data related to the error. - name: item | type: Section | description: Created section. Only returned if `returnEntity` is set to `true`. - name: _id | type: string | description: Section GUID. - name: revision | type: string | description: Revision number, which increments by 1 each time the section is updated. To prevent conflicting changes, the current revision must be passed when updating the section. Ignored when creating a section. - name: _createdDate | type: Date | description: Date and time the section was created. - name: _updatedDate | type: Date | description: Date and time the section was updated. - name: name | type: string | description: Section name. - name: description | type: string | description: Section description. - name: image | type: string | description: Main section image. - name: additionalImages | type: array | description: Additional section images. - name: itemIds | type: array | description: Item GUIDs. - name: extendedFields | type: ExtendedFields | description: Extended fields. - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). - name: visible | type: boolean | description: Whether the section is visible in the menu for site visitors. - name: businessLocationId | type: string | description: GUID of the business location ([SDK](https://dev.wix.com/docs/sdk/backend-modules/restaurants/wix-restaurants-new/about-business-locations.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/restaurants/wix-restaurants-new/about-business-locations.md)) where this section is available. - name: bulkActionMetadata | type: BulkActionMetadata | description: Metadata for the API call. - name: totalSuccesses | type: integer | description: Number of items that were successfully processed. - name: totalFailures | type: integer | description: Number of items that couldn't be processed. - name: undetailedFailures | type: integer | description: Number of failures without details because detailed failure threshold was exceeded. ``` ### Examples ### Create multiple sections ```javascript import { sections } from "@wix/restaurants"; const sectionsToCreate = [ { name: "Mains", description: "A diverse range of flavorful dishes which are all sourced daily and locally" }, { name: "Appetizers", description: "These dishes are great for sharing" } ]; const options = { returnEntity: true }; async function bulkCreateSections() { const response = await sections.bulkCreateSections(sectionsToCreate, options); } /* Promise resolves to: * { * "results": [ * { * "itemMetadata": { * "_id": "74053ee9-ccf8-4916-918a-400942268a07", * "originalIndex": 0, * "success": true * }, * "item": { * "_id": "74053ee9-ccf8-4916-918a-400942268a07", * "revision": "1", * "name": "Mains", * "description": "A diverse range of flavorful dishes which are all sourced daily and locally", * "visible": true * } * }, * { * "itemMetadata": { * "_id": "725664c8-f63b-4da6-bad3-cf90f32ed608", * "originalIndex": 1, * "success": true * }, * "item": { * "_id": "725664c8-f63b-4da6-bad3-cf90f32ed608", * "revision": "1", * "name": "Appetizers", * "description": "These dishes are great for sharing", * "visible": true * } * } * ], * "bulkActionMetadata": { * "totalSuccesses": 2, * "totalFailures": 0 * } * } */ ``` ### bulkCreateSections (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { sections } from '@wix/restaurants'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { sections }, // Include the auth strategy and host as relevant }); async function bulkCreateSections(sections,options) { const response = await myWixClient.sections.bulkCreateSections(sections,options); }; ``` ---