Wix Restaurants Setup API Reference

This recipe covers setting up and configuring Wix Restaurants using the REST API, including menus, items, and ordering configuration.

Prerequisites

1. Wix Restaurants app installed on the site
2. API access with restaurant management permissions

Required APIs

• Menus API: REST
• Menu Items API: REST
• Menu Sections API: REST
• Item Modifier Groups API: REST
• Item Variants API: REST

Overview

Wix Restaurants uses a hierarchical structure:

• Menus (e.g., Breakfast, Lunch, Dinner)
  • Sections (e.g., Appetizers, Main Courses, Desserts)
    • Items (e.g., Caesar Salad, Grilled Salmon)

Step 1: Create a Menu

Endpoint: POST https://www.wixapis.com/restaurants/menus-menu/v1/menus

Request Body:

Response:

Step 2: Create Menu Sections

Endpoint: POST https://www.wixapis.com/restaurants/menus-section/v1/sections

Request Body:

Create multiple sections:

Step 3: Create Menu Items

Endpoint: POST https://www.wixapis.com/restaurants/menus-item/v1/items

Request Body:

Step 4: Add Items to Sections

Endpoint: PATCH https://www.wixapis.com/restaurants/menus-section/v1/sections/{sectionId}

Each section update requires the latest section revision.

Step 5: Configure Item Options and Modifiers

Create modifiers for customization (e.g., cooking temperature, add-ons):

Endpoint: POST https://www.wixapis.com/restaurants/item-modifier-group/v1/modifier-groups

Add-on modifier with pricing:

Step 6: Set Menu Structure (Attach Sections to Menu)

Attach section IDs to a menu. This call requires the latest menu revision.

Endpoint: PATCH https://www.wixapis.com/restaurants/menus-menu/v1/menus/{menuId}

Step 7: Bulk Operations for Large Menus

For restaurant setup flows with many sections/items, use bulk endpoints:

• Bulk Create Sections: POST https://www.wixapis.com/restaurants/menus-section/v1/bulk/sections/create
• Bulk Create Items: POST https://www.wixapis.com/restaurants/menus-item/v1/bulk/items/create
• Bulk Create Variants: POST https://www.wixapis.com/restaurants/item-variants/v1/bulk/variants/create

Step 8: Query Menus / Sections / Items

Use query APIs for retrieval and UI display flows.

• Query Menus: POST https://www.wixapis.com/restaurants/menus-menu/v1/menus/query
• Query Sections: POST https://www.wixapis.com/restaurants/menus-section/v1/sections/query
• Query Items: POST https://www.wixapis.com/restaurants/menus-item/v1/items/query

Query Menus

Endpoint: GET https://www.wixapis.com/restaurants/menus-menu/v1/menus

Response:

Recommended Setup Order

For complex restaurant menus, use this order to avoid dependency issues:

1. Create variants (sizes/options) if needed.
2. Create items (single or bulk).
3. Create sections (single or bulk).
4. Update each section with itemIds.
5. Update menu with sectionIds.

Item Labels

Common dietary labels:

• vegetarian
• vegan
• gluten-free
• gluten-free-option
• dairy-free
• nut-free
• spicy
• chef-recommendation

Best Practices

1. High-Quality Images: Use appetizing food photography
2. Clear Descriptions: Include ingredients and preparation methods
3. Accurate Pricing: Keep prices up-to-date
4. Stock Management: Update availability in real-time
5. Modifier Organization: Group related customizations logically
6. Menu Structure: Organize sections in logical dining order

Error Handling

Related Documentation

• Menus API Reference
• Menu Items API Reference
• Menu Sections API Reference
• Restaurant Orders API