> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.argolabs.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.argolabs.ai/_mcp/server.

# Create Menu Configuration

POST https://api.argolabs.ai/v1/stores/{store_argo_id}/menu_configuration/
Content-Type: application/json

Reference: https://docs.argolabs.ai/api-reference/menu/create-menu-configuration

## Authentication

- `x-api-key` header (required) — API Key authentication via header

## Request

### Path parameters

- `store_argo_id` (string, required)

### Body (application/json)

This endpoint expects an object.

- `items` (list of MenuItemRequest, required)
- `menus` (list of MenuRequest, optional)
- `categories` (list of CategoryRequest, optional)
- `modifier_groups` (list of ModifierGroupRequest, optional)
- `modifier_items` (list of ModifierItem, optional)

## Response

### 200

- `menu_configuration` (list of MenuTree, required)

## Errors

### 422 Unprocessable Entity

Validation Error

- `detail` (list of ValidationError, optional)

## Types

### MenuItemRequest

- `external_id` (string, required)
- `name` (MultilingualText, required)
- `price` (integer, required)
- `tax` (integer, required)
- `sell_separately` (boolean, required)
- `description` (MultilingualText, optional)
- `in_stock` (boolean, optional)
- `ingredients` (string, optional)
- `allergens` (string, optional)
- `dietary_labels` (list of enum, optional)
  - Allowed values: `VEGAN`, `VEGETARIAN`, `GLUTEN_FREE`
- `prep_time` (integer, optional)
- `alcohol_by_volume` (double, optional)
- `modifier_external_ids` (list of string, optional)

### MenuRequest

- `external_id` (string, required)
- `availability` (list of Availability, required)
- `name` (MultilingualText, optional)
- `category_external_ids` (list of string, optional)

### CategoryRequest

- `external_id` (string, required)
- `name` (MultilingualText, required)
- `description` (MultilingualText, optional)
- `item_external_ids` (list of string, optional)

### ModifierGroupRequest

- `external_id` (string, required)
- `type` (string, required)
- `name` (MultilingualText, required)
- `group_max` (integer, required)
- `group_min` (integer, required)
- `charge_after` (integer, required)
- `description` (MultilingualText, optional)
- `modifier_item_external_ids` (list of string, optional)

### ModifierItem

- `external_id` (string, required)
- `name` (MultilingualText, required)
- `price_change` (integer, required)
- `tax_change` (integer, required)
- `min_quantity` (integer, required)
- `max_quantity` (integer, required)
- `default_quantity` (integer, required)
- `menu_item_external_id` (string, optional)
- `description` (MultilingualText, optional)
- `in_stock` (boolean, optional)

### MenuTree

- `id` (integer, required)
- `external_id` (string, required)
- `name` (MultilingualText, required)
- `categories` (list of CategoryTree, required)
- `availability` (list of Availability, required)

### ValidationError

- `loc` (list of ValidationErrorLocItem, required)
- `msg` (string, required)
- `type` (string, required)

### MultilingualText

- `translations` (map from string to string, required)

### Availability

- `day_of_week` (string, required)
- `time_periods` (list of TimePeriodsRequest, required)

### CategoryTree

- `id` (integer, required)
- `external_id` (string, required)
- `name` (MultilingualText, required)
- `items` (list of MenuItemTree, required)
- `description` (MultilingualText, optional)

### ValidationErrorLocItem

### TimePeriodsRequest

- `start_time` (string, required)
- `end_time` (string, required)

### MenuItemTree

- `id` (integer, required)
- `external_id` (string, required)
- `name` (MultilingualText, required)
- `price` (integer, required)
- `tax` (integer, required)
- `in_stock` (boolean, required)
- `sell_separately` (boolean, required)
- `modifier_groups` (list of ModifierGroupTree, required)
- `description` (MultilingualText, optional)
- `ingredients` (string, optional)
- `allergens` (string, optional)
- `dietary_labels` (list of enum, optional)
  - Allowed values: `VEGAN`, `VEGETARIAN`, `GLUTEN_FREE`
- `prep_time` (integer, optional)
- `alcohol_by_volume` (double, optional)
- `prep_type` (string, optional)

### ModifierGroupTree

- `id` (integer, required)
- `external_id` (string, required)
- `type` (string, required)
- `name` (MultilingualText, required)
- `group_max` (integer, required)
- `group_min` (integer, required)
- `charge_after` (integer, required)
- `modifier_items` (list of ModifierItemTree, required)
- `description` (MultilingualText, optional)

### ModifierItemTree

- `id` (integer, required)
- `external_id` (string, required)
- `name` (MultilingualText, required)
- `price_change` (integer, required)
- `tax_change` (integer, required)
- `in_stock` (boolean, required)
- `min_quantity` (integer, required)
- `max_quantity` (integer, required)
- `default_quantity` (integer, required)
- `menu_item_external_id` (string, optional)
- `description` (MultilingualText, optional)

## Examples

**Request**

```json
{
  "items": [
    {
      "external_id": "external_id",
      "name": {
        "translations": {
          "key": "value"
        }
      },
      "price": 1,
      "tax": 1,
      "sell_separately": true
    }
  ]
}
```

**Response**

```json
{
  "menu_configuration": [
    {
      "id": 1,
      "external_id": "external_id",
      "name": {
        "translations": {
          "key": "value"
        }
      },
      "categories": [
        {
          "id": 1,
          "external_id": "external_id",
          "name": {
            "translations": {
              "key": "value"
            }
          },
          "items": [
            {
              "id": 1,
              "external_id": "external_id",
              "name": {
                "translations": {
                  "key": "value"
                }
              },
              "price": 1,
              "tax": 1,
              "in_stock": true,
              "sell_separately": true,
              "modifier_groups": [
                {
                  "id": 1,
                  "external_id": "external_id",
                  "type": "type",
                  "name": {
                    "translations": {
                      "key": "value"
                    }
                  },
                  "group_max": 1,
                  "group_min": 1,
                  "charge_after": 1,
                  "modifier_items": [
                    {
                      "id": 1,
                      "external_id": "external_id",
                      "name": {
                        "translations": {
                          "key": "value"
                        }
                      },
                      "price_change": 1,
                      "tax_change": 1,
                      "in_stock": true,
                      "min_quantity": 1,
                      "max_quantity": 1,
                      "default_quantity": 1
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "availability": [
        {
          "day_of_week": "day_of_week",
          "time_periods": [
            {
              "start_time": "start_time",
              "end_time": "end_time"
            }
          ]
        }
      ]
    }
  ]
}
```

**SDK Code**

```python
import requests

url = "https://api.argolabs.ai/v1/stores/store_07Tjin0Daw7e6QQzX1Dwc/menu_configuration/"

payload = { "items": [
        {
            "external_id": "external_id",
            "name": { "translations": { "key": "value" } },
            "price": 1,
            "tax": 1,
            "sell_separately": True
        }
    ] }
headers = {
    "x-api-key": "<ApiKeyAuthScheme>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.argolabs.ai/v1/stores/store_07Tjin0Daw7e6QQzX1Dwc/menu_configuration/';
const options = {
  method: 'POST',
  headers: {'x-api-key': '<ApiKeyAuthScheme>', 'Content-Type': 'application/json'},
  body: '{"items":[{"external_id":"external_id","name":{"translations":{"key":"value"}},"price":1,"tax":1,"sell_separately":true}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.argolabs.ai/v1/stores/store_07Tjin0Daw7e6QQzX1Dwc/menu_configuration/"

	payload := strings.NewReader("{\n  \"items\": [\n    {\n      \"external_id\": \"external_id\",\n      \"name\": {\n        \"translations\": {\n          \"key\": \"value\"\n        }\n      },\n      \"price\": 1,\n      \"tax\": 1,\n      \"sell_separately\": true\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<ApiKeyAuthScheme>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.argolabs.ai/v1/stores/store_07Tjin0Daw7e6QQzX1Dwc/menu_configuration/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<ApiKeyAuthScheme>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"items\": [\n    {\n      \"external_id\": \"external_id\",\n      \"name\": {\n        \"translations\": {\n          \"key\": \"value\"\n        }\n      },\n      \"price\": 1,\n      \"tax\": 1,\n      \"sell_separately\": true\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.argolabs.ai/v1/stores/store_07Tjin0Daw7e6QQzX1Dwc/menu_configuration/")
  .header("x-api-key", "<ApiKeyAuthScheme>")
  .header("Content-Type", "application/json")
  .body("{\n  \"items\": [\n    {\n      \"external_id\": \"external_id\",\n      \"name\": {\n        \"translations\": {\n          \"key\": \"value\"\n        }\n      },\n      \"price\": 1,\n      \"tax\": 1,\n      \"sell_separately\": true\n    }\n  ]\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.argolabs.ai/v1/stores/store_07Tjin0Daw7e6QQzX1Dwc/menu_configuration/', [
  'body' => '{
  "items": [
    {
      "external_id": "external_id",
      "name": {
        "translations": {
          "key": "value"
        }
      },
      "price": 1,
      "tax": 1,
      "sell_separately": true
    }
  ]
}',
  'headers' => [
    'Content-Type' => 'application/json',
    'x-api-key' => '<ApiKeyAuthScheme>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.argolabs.ai/v1/stores/store_07Tjin0Daw7e6QQzX1Dwc/menu_configuration/");
var request = new RestRequest(Method.POST);
request.AddHeader("x-api-key", "<ApiKeyAuthScheme>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"items\": [\n    {\n      \"external_id\": \"external_id\",\n      \"name\": {\n        \"translations\": {\n          \"key\": \"value\"\n        }\n      },\n      \"price\": 1,\n      \"tax\": 1,\n      \"sell_separately\": true\n    }\n  ]\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "x-api-key": "<ApiKeyAuthScheme>",
  "Content-Type": "application/json"
]
let parameters = ["items": [
    [
      "external_id": "external_id",
      "name": ["translations": ["key": "value"]],
      "price": 1,
      "tax": 1,
      "sell_separately": true
    ]
  ]] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.argolabs.ai/v1/stores/store_07Tjin0Daw7e6QQzX1Dwc/menu_configuration/")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```