Upsert menus

curl --request PUT \
  --url 'https://firespark.cloud/api/integrations/v1/menus?fulfillment_id=delivery&store_id=downtown&channel_id=app&brand_id=0001' \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-release-id: 2026-07-03-baseline" \
  -d '{
    "style": "DEFAULT",
    "products": [
      {
        "id": "burger-classic",
        "name": { "en_us": "Classic burger" },
        "description": { "en_us": "Angus beef patty with lettuce and tomato." },
        "image_url": "https://cdn.example.com/burger-classic.jpg",
        "bundled_items": [],
        "pricing": {
          "minimum_quantity": 1,
          "maximum_quantity": 10,
          "is_tax_inclusive": true,
          "tax_rate": 0.15,
          "price": 12.99,
          "anchor_price": 14.99,
          "anchor_price_percentage": 0.13,
          "modifiers": [],
          "modifier_group_ids": ["choose-drink"]
        },
        "availability": {
          "status": "AVAILABLE",
          "schedules": null,
          "out_of_stock_until": null
        },
        "metadata": {}
      },
      {
        "id": "soda",
        "name": { "en_us": "Soda" },
        "description": null,
        "image_url": null,
        "bundled_items": [],
        "pricing": {
          "minimum_quantity": 0,
          "maximum_quantity": 1,
          "is_tax_inclusive": true,
          "tax_rate": 0.15,
          "price": 0,
          "anchor_price": 0,
          "anchor_price_percentage": 0,
          "modifiers": [],
          "modifier_group_ids": []
        },
        "availability": {
          "status": "AVAILABLE",
          "schedules": null,
          "out_of_stock_until": null
        },
        "metadata": {}
      },
      {
        "id": "cola",
        "name": { "en_us": "Cola" },
        "description": null,
        "image_url": null,
        "bundled_items": [],
        "pricing": {
          "minimum_quantity": 0,
          "maximum_quantity": 1,
          "is_tax_inclusive": true,
          "tax_rate": 0.15,
          "price": 0,
          "anchor_price": 0,
          "anchor_price_percentage": 0,
          "modifiers": [],
          "modifier_group_ids": []
        },
        "availability": {
          "status": "AVAILABLE",
          "schedules": null,
          "out_of_stock_until": null
        },
        "metadata": {}
      }
    ],
    "categories": [
      {
        "id": "mains",
        "name": { "en_us": "Mains" },
        "description": { "en_us": "Burgers and sandwiches" },
        "image_url": "https://cdn.example.com/mains.jpg",
        "items": [{ "type": "PRODUCT", "id": "burger-classic" }],
        "availability": {
          "status": "ACTIVE",
          "schedules": null,
          "inactive_until": null
        },
        "metadata": {}
      }
    ],
    "modifier_groups": [
      {
        "id": "choose-drink",
        "title": { "en_us": "Choose a drink" },
        "description": null,
        "display_type": "LIST",
        "modifier_ids": ["cola", "soda"],
        "minimum_quantity": 0,
        "maximum_quantity": 1,
        "charge_above_quantity": null,
        "metadata": {}
      }
    ],
    "menus": [
      {
        "id": "lunch-delivery",
        "name": { "en_us": "Lunch delivery menu" },
        "description": { "en_us": "Weekday lunch items for app delivery" },
        "schedules": null,
        "metadata": {},
        "category_ids": ["mains"],
        "status": "ACTIVE"
      }
    ]
  }'

curl --request PUT \
  --url 'https://firespark.cloud/api/integrations/v1/menus?fulfillment_id=delivery&store_id=downtown&channel_id=uber-eats&brand_id=0001' \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-release-id: 2026-07-03-uber" \
  -d '{
    "style": "UBER_EATS",
        "display_options": {
          "disable_item_instructions": true
        },
        "items": [
          {
            "id": "Coffee",
            "title": { "translations": { "en_us": "Coffee" } },
            "description": { "translations": { "en_us": "Deliciously roasted beans" } },
            "modifier_group_ids": { "ids": ["Add-milk"] },
            "price_info": { "price": 300 },
            "tax_info": { "tax_rate": 8 },
            "quantity_info": {}
          },
          {
            "id": "Milk",
            "title": { "translations": { "en_us": "Milk" } },
            "quantity_info": {
              "overrides": [
                {
                  "context_type": "MODIFIER_GROUP",
                  "context_value": "Add-milk",
                  "quantity": { "max_permitted": 1 }
                }
              ]
            },
            "price_info": {
              "price": 0,
              "overrides": [
                {
                  "context_type": "MODIFIER_GROUP",
                  "context_value": "Add-milk",
                  "price": 0
                }
              ]
            },
            "tax_info": { "tax_rate": 8 }
          }
        ],
        "categories": [
          {
            "id": "Drinks",
            "title": { "translations": { "en_us": "Drinks" } },
            "entities": [{ "type": "ITEM", "id": "Coffee" }]
          }
        ],
        "modifier_groups": [
          {
            "id": "Add-milk",
            "title": { "translations": { "en_us": "Add milk" } },
            "modifier_options": [{ "type": "ITEM", "id": "Milk" }],
            "quantity_info": { "quantity": { "max_permitted": 1 } },
            "display_type": null
          }
        ],
        "menus": [
          {
            "id": "All-day",
            "title": { "translations": { "en_us": "All day" } },
            "category_ids": ["Drinks"],
            "service_availability": [
              {
                "day_of_week": "monday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "tuesday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "wednesday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "thursday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "friday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "saturday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "sunday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              }
            ]
          }
        ]
      }'

Creates or updates composed menus for the authenticated merchant. Send catalog entities once at the top level, then reference them from up to 10 menu definitions in the same request. Each menu in menus is matched by id. When no menu exists with that id for the merchant, Fire spark creates it. When one already exists, Fire spark updates the writable fields below. Omitted fields keep their current values on update. Scope the upsert with optional query parameters. Fire spark resolves organization and merchant context from your access token.

Requires an access token with the menus:write scope. See Token to obtain a token.

Menu id values are immutable. You cannot change an existing menu’s id through this endpoint — send the same id you use in your POS or RMS on every sync.

Headers

Header	Required	Description
`x-release-id`	No	Release identifier for this sync. Alphanumeric characters, `_`, and `-` only. 1–64 characters. When omitted, Fire spark generates a value like `v2026-07-10-21h`. Reuse the same value across scopes when rolling out one catalog version to many stores or channels. Each store, channel, and brand scope accepts a given release only once.
`x-force`	No	When `true` or `1`, menu changes in the dashboard and via API will be overwritten; otherwise, existing changes persist.
`x-publish`	No	Defaults to `true`. When `false` or `0`, the sync pauses before publishing so you can review and publish from the dashboard. With `x-force: true`, the pause happens before override pruning as well.

Query parameters

Parameter	Required	Description
`fulfillment_id`	No	External fulfillment identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. When omitted, the upsert applies to all fulfillment types. See List fulfillment.
`store_id`	No	External store identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. When omitted, the upsert applies to all stores.
`channel_id`	No	External channel identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. When omitted, the upsert applies to all channels.
`brand_id`	No	External brand identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. Omit or pass `__ANY__` for the merchant-wide default. When set, scopes the upsert to menus for this brand.

Omit scope query parameters for an optional merchant-wide default — useful when store, channel, or fulfillment is not chosen yet. Add fulfillment_id, store_id, channel_id, and/or brand_id to override that default for a specific selling context. Omit a scope parameter or pass __ANY__ to store the wildcard for that dimension. See Menu sync for the recommended baseline-and-override workflow.

Sync styles

The request body is a discriminated union on style. Fire spark validates each variant against a different schema.

Style	When to use
`DEFAULT`	Fire spark native format — owned channels such as app, web, or kiosk.
`UBER_EATS`	Uber Eats Menu API v2 format — push menus to Uber Eats without mapping fields yourself.

Send "style": "DEFAULT" or "style": "UBER_EATS" at the top level. Shared catalog entities and up to 10 menu definitions are sent in the same request for both styles.

Request

Switch between DEFAULT and UBER_EATS in the request examples panel to see both payload shapes. Both calls use PUT with scope query parameters (fulfillment_id, store_id, channel_id, brand_id).

curl --request PUT \
  --url 'https://firespark.cloud/api/integrations/v1/menus?fulfillment_id=delivery&store_id=downtown&channel_id=app&brand_id=0001' \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-release-id: 2026-07-03-baseline" \
  -d '{
    "style": "DEFAULT",
    "products": [
      {
        "id": "burger-classic",
        "name": { "en_us": "Classic burger" },
        "description": { "en_us": "Angus beef patty with lettuce and tomato." },
        "image_url": "https://cdn.example.com/burger-classic.jpg",
        "bundled_items": [],
        "pricing": {
          "minimum_quantity": 1,
          "maximum_quantity": 10,
          "is_tax_inclusive": true,
          "tax_rate": 0.15,
          "price": 12.99,
          "anchor_price": 14.99,
          "anchor_price_percentage": 0.13,
          "modifiers": [],
          "modifier_group_ids": ["choose-drink"]
        },
        "availability": {
          "status": "AVAILABLE",
          "schedules": null,
          "out_of_stock_until": null
        },
        "metadata": {}
      },
      {
        "id": "soda",
        "name": { "en_us": "Soda" },
        "description": null,
        "image_url": null,
        "bundled_items": [],
        "pricing": {
          "minimum_quantity": 0,
          "maximum_quantity": 1,
          "is_tax_inclusive": true,
          "tax_rate": 0.15,
          "price": 0,
          "anchor_price": 0,
          "anchor_price_percentage": 0,
          "modifiers": [],
          "modifier_group_ids": []
        },
        "availability": {
          "status": "AVAILABLE",
          "schedules": null,
          "out_of_stock_until": null
        },
        "metadata": {}
      },
      {
        "id": "cola",
        "name": { "en_us": "Cola" },
        "description": null,
        "image_url": null,
        "bundled_items": [],
        "pricing": {
          "minimum_quantity": 0,
          "maximum_quantity": 1,
          "is_tax_inclusive": true,
          "tax_rate": 0.15,
          "price": 0,
          "anchor_price": 0,
          "anchor_price_percentage": 0,
          "modifiers": [],
          "modifier_group_ids": []
        },
        "availability": {
          "status": "AVAILABLE",
          "schedules": null,
          "out_of_stock_until": null
        },
        "metadata": {}
      }
    ],
    "categories": [
      {
        "id": "mains",
        "name": { "en_us": "Mains" },
        "description": { "en_us": "Burgers and sandwiches" },
        "image_url": "https://cdn.example.com/mains.jpg",
        "items": [{ "type": "PRODUCT", "id": "burger-classic" }],
        "availability": {
          "status": "ACTIVE",
          "schedules": null,
          "inactive_until": null
        },
        "metadata": {}
      }
    ],
    "modifier_groups": [
      {
        "id": "choose-drink",
        "title": { "en_us": "Choose a drink" },
        "description": null,
        "display_type": "LIST",
        "modifier_ids": ["cola", "soda"],
        "minimum_quantity": 0,
        "maximum_quantity": 1,
        "charge_above_quantity": null,
        "metadata": {}
      }
    ],
    "menus": [
      {
        "id": "lunch-delivery",
        "name": { "en_us": "Lunch delivery menu" },
        "description": { "en_us": "Weekday lunch items for app delivery" },
        "schedules": null,
        "metadata": {},
        "category_ids": ["mains"],
        "status": "ACTIVE"
      }
    ]
  }'

curl --request PUT \
  --url 'https://firespark.cloud/api/integrations/v1/menus?fulfillment_id=delivery&store_id=downtown&channel_id=uber-eats&brand_id=0001' \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-release-id: 2026-07-03-uber" \
  -d '{
    "style": "UBER_EATS",
        "display_options": {
          "disable_item_instructions": true
        },
        "items": [
          {
            "id": "Coffee",
            "title": { "translations": { "en_us": "Coffee" } },
            "description": { "translations": { "en_us": "Deliciously roasted beans" } },
            "modifier_group_ids": { "ids": ["Add-milk"] },
            "price_info": { "price": 300 },
            "tax_info": { "tax_rate": 8 },
            "quantity_info": {}
          },
          {
            "id": "Milk",
            "title": { "translations": { "en_us": "Milk" } },
            "quantity_info": {
              "overrides": [
                {
                  "context_type": "MODIFIER_GROUP",
                  "context_value": "Add-milk",
                  "quantity": { "max_permitted": 1 }
                }
              ]
            },
            "price_info": {
              "price": 0,
              "overrides": [
                {
                  "context_type": "MODIFIER_GROUP",
                  "context_value": "Add-milk",
                  "price": 0
                }
              ]
            },
            "tax_info": { "tax_rate": 8 }
          }
        ],
        "categories": [
          {
            "id": "Drinks",
            "title": { "translations": { "en_us": "Drinks" } },
            "entities": [{ "type": "ITEM", "id": "Coffee" }]
          }
        ],
        "modifier_groups": [
          {
            "id": "Add-milk",
            "title": { "translations": { "en_us": "Add milk" } },
            "modifier_options": [{ "type": "ITEM", "id": "Milk" }],
            "quantity_info": { "quantity": { "max_permitted": 1 } },
            "display_type": null
          }
        ],
        "menus": [
          {
            "id": "All-day",
            "title": { "translations": { "en_us": "All day" } },
            "category_ids": ["Drinks"],
            "service_availability": [
              {
                "day_of_week": "monday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "tuesday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "wednesday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "thursday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "friday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "saturday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              },
              {
                "day_of_week": "sunday",
                "time_periods": [{ "start_time": "00:00", "end_time": "23:59" }]
              }
            ]
          }
        ]
      }'

Default
Uber Eats

Fire spark native payload. Products, categories, and modifier groups use Fire spark field names (name, pricing, items, and so on).

Uber Eats Menu API v2 payload. Top-level products become items; localized strings use a translations object. Prices are integer cents in price_info.price.See Uber’s example menu payloads for nested modifiers, bundled items, tax labels, and other advanced fields.

Request body

Default
Uber Eats

Field	Required	Description
`style`	Yes	Must be `"DEFAULT"`.
`products`	Yes	Product definitions shared across menus in this request. At least 1 entry. At most 1000.
`categories`	Yes	Category definitions shared across menus in this request. At least 1 entry. At most 100.
`modifier_groups`	No	Modifier group definitions. Omit or set `null` when unused. At most 1000 when provided.
`variant_groups`	No	Variant group definitions (questions that resolve the product id). At most 1000. Defaults to `[]`. See Variants.
`recommendations`	No	Recommendation catalog shared across menus in this request. At most 1000 when provided. Defaults to `[]`.
`menus`	Yes	Menu definitions to create or update. At least 1 entry. At most 10.

Each object in menus accepts these writable fields:

Field	Required on create	Description
`id`	Yes	External menu identifier. Upsert key. Immutable after creation.
`name`	Yes	Localized display name keyed by locale (for example `en_us`). Each value is 1–1024 characters.
`description`	No	Localized description keyed by locale. `null` when omitted. Each value is 1–1024 characters.
`schedules`	No	Weekly schedule entries. `null` or omitted for 24/7. When set, must include all 7 weekdays with non-overlapping periods. See Validation rules.
`metadata`	No	Partner-specific metadata. Defaults to `{}`.
`category_ids`	Yes	Category ids to include in this menu. At least 1 entry. At most 100.
`status`	Yes	`ACTIVE` or `INACTIVE`.

products

Each product in the request body:

Field	Required	Type	Description

| id | Yes | string | External product identifier. | | name | Yes | object | Localized display name keyed by locale (for example en_us). | | description | No | object | null | Localized description. null when omitted. | | image_url | No | string | Product image URL. JPG, PNG, or WebP. Fire spark copies it to public storage and serves a render URL so clients can add width, height, and resize. null when omitted. | | bundled_items | No | array | Items included in a bundle or combo. Defaults to []. | | pricing | Yes | object | Price, tax, quantity limits, and modifier configuration. See pricing. | | availability | Yes | object | Product availability. See fields below. | | labels | No | string[] | Short labels for Dashboard filters and quick selection. At most 64 strings (1–128 characters each). Defaults to []. | | tags | No | object | Key/value tags for advanced custom rules. Values may be boolean, string, or number. Defaults to {}. See Custom rules. | | metadata | No | object | Partner-specific metadata. Defaults to {}. |Each availability object:

Field	Required	Type	Description
`status`	Yes	string	`AVAILABLE`, `HIDDEN`, or `OUT_OF_STOCK`.
`schedules`	No	array \| null	Weekly schedule entries. `null` or omitted for no restriction. When set, must include all 7 weekdays. See Validation rules.
`out_of_stock_until`	No	string	Optional ISO 8601 datetime when the product returns to stock.

Each bundled_items entry:

Field	Required	Type	Description

Example product

{
  "id": "burger-classic",
  "name": { "en_us": "Classic burger" },
  "description": { "en_us": "Angus beef patty with lettuce and tomato." },
  "image_url": "https://cdn.example.com/burger-classic.jpg",
  "bundled_items": [],
  "pricing": {
    "minimum_quantity": 1,
    "maximum_quantity": 10,
    "is_tax_inclusive": true,
    "tax_rate": 0.15,
    "price": 12.99,
    "anchor_price": 14.99,
    "anchor_price_percentage": 0.13,
    "modifiers": [],
    "modifier_group_ids": ["choose-drink"]
  },
  "availability": {
    "status": "AVAILABLE",
    "schedules": null,
    "out_of_stock_until": null
  },
  "metadata": {}
}

categories

Each category in the request body:

Field	Required	Type	Description

| id | Yes | string | External category identifier. | | name | Yes | object | Localized display name keyed by locale. | | description | No | object | null | Localized description. null when omitted. | | image_url | No | string | Category image URL. Must be a JPG, PNG, or WebP. null when omitted. | | items | Yes | array | Ordered category entries. At least 1 entry. At most 1000. | | availability | Yes | object | Category availability. See fields below. | | labels | No | string[] | Short labels for Dashboard filters and quick selection. At most 64 strings (1–128 characters each). Defaults to []. | | tags | No | object | Key/value tags for advanced custom rules. Values may be boolean, string, or number. Defaults to {}. See Custom rules. | | metadata | No | object | Partner-specific metadata. Defaults to {}. |Each entry in items:

Field	Required	Type	Description
`type`	Yes	string	`CATEGORY` or `PRODUCT`.
`id`	Yes	string	External category or product identifier.

Each availability object:

Field	Required	Type	Description
`status`	Yes	string	`ACTIVE`, `INACTIVE`, or `HIDDEN`.
`schedules`	No	array \| null	Weekly schedule entries. `null` or omitted for no restriction. When set, must include all 7 weekdays. See Validation rules.
`inactive_until`	No	string	Optional ISO 8601 datetime when the category becomes active again.

Example category

{
  "id": "mains",
  "name": { "en_us": "Mains" },
  "description": { "en_us": "Burgers and sandwiches" },
  "image_url": "https://cdn.example.com/mains.jpg",
  "items": [{ "type": "PRODUCT", "id": "burger-classic" }],
  "availability": {
    "status": "ACTIVE",
    "schedules": null,
    "inactive_until": null
  },
  "metadata": {}
}

modifier_groups

Each modifier group in the request body:

Field	Required	Type	Description

| id | Yes | string | External modifier group identifier. Referenced from pricing.modifier_group_ids. | | title | Yes | object | Localized group title keyed by locale. | | description | No | object | null | Localized description. null when omitted. | | display_type | No | string | GRID or LIST. | | modifier_ids | Yes | array | Product UUIDs for modifiers in this group. 1–100 entries. A single-option group is valid. | | minimum_quantity | Yes | number | Minimum selections required. ≥ 0. | | maximum_quantity | Yes | number | Maximum selections allowed. 0–1,000,000. | | charge_above_quantity | No | number | Number of free selections before additional charges apply. Optional. | | metadata | No | object | Partner-specific metadata. Defaults to {}. |

Example modifier group

{
  "id": "choose-drink",
  "title": { "en_us": "Choose a drink" },
  "description": null,
  "display_type": "LIST",
  "modifier_ids": ["cola", "soda"],
  "minimum_quantity": 0,
  "maximum_quantity": 1,
  "charge_above_quantity": null,
  "metadata": {}
}

recommendations

Each recommendation in the top-level catalog:

Field	Required	Type	Description
`id`	Yes	string	External recommendation identifier. Must be unique in the request.
`title`	Yes	object	Localized display name keyed by locale.
`description`	No	object \| null	Localized description. `null` when omitted.
`type`	Yes	string	`UPSELL`, `CROSS_SELL`, or `DOWNSELL`.
`target_product_id`	Yes	string	Product `id` to recommend. Must exist in `products`.
`metadata`	No	object	Partner-specific metadata. Defaults to `{}`.

Example recommendation

{
  "id": "upsell-fries",
  "type": "UPSELL",
  "title": { "en_us": "Add fries" },
  "description": { "en_us": "Side of seasoned fries." },
  "target_product_id": "fries",
  "metadata": {}
}

variant_groups

Each variant group:

Field	Required	Type	Description
`id`	Yes	string	External variant group identifier. Referenced from `pricing.variant_group_ids`.
`title`	Yes	object	Localized question keyed by locale.
`description`	No	object \| null	Localized description.
`display_type`	No	string	`GRID` or `LIST`.
`variants`	Yes	array	Options in this group. 1–100 entries. See fields below.
`metadata`	No	object	Partner-specific metadata. Defaults to `{}`.

Each entry in variants:

Field	Required	Type	Description
`id`	Yes	string	Option identifier, unique across all variant groups. Referenced from `pricing.variants[].variant_group_option_ids`.
`name`	Yes	object	Localized option label keyed by locale.
`description`	No	object \| null	Localized description.
`image_url`	No	string \| null	Option image URL. Must be a JPG, PNG, or WebP; it is copied to Firespark storage like product images.
`product_ids`	Yes	array	Variant products this option can lead to. Each must exist and list this option in its `pricing.variants`. 1–1000 entries.
`metadata`	No	object	Partner-specific metadata. Defaults to `{}`.

Example variant group

{
  "id": "size",
  "title": { "en_us": "Size" },
  "description": null,
  "display_type": "GRID",
  "variants": [
    { "id": "medium", "name": { "en_us": "Medium" }, "description": null, "image_url": null, "product_ids": ["pep-m-thin", "pep-m-thick"], "metadata": {} },
    { "id": "large", "name": { "en_us": "Large" }, "description": null, "image_url": null, "product_ids": ["pep-l-thin", "pep-l-thick"], "metadata": {} }
  ],
  "metadata": {}
}

pricing

Product pricing in the request body:

Field	Required	Type	Description

| minimum_quantity | No | number | Minimum units per order. ≥ 0. Defaults to 0. | | maximum_quantity | No | number | Maximum units per order. 0–1,000,000. Defaults to 1000000. | | is_tax_inclusive | Yes | boolean | Whether price includes tax. | | tax_rate | Yes | number | Tax rate as a decimal (for example 0.15 for 15%). 0–1. | | price | Yes | number | List price. ≥ 0. | | anchor_price | No | number | Reference price for strikethrough or comparison. ≥ 0. | | anchor_price_percentage | No | number | Discount shown relative to anchor_price. 0–1. | | starting_price | No | number | null | Reference “From” price. Omit it and Fire spark calculates the lowest price that satisfies every required modifier during sync. Send null to never show it. ≥ 0. | | modifiers | No | array | Per-group pricing and selection overrides. Defaults to []. | | modifier_group_ids | No | array | External modifier group identifiers attached to this product. Defaults to []. | | variant_group_ids | No | array | Variant groups asked on this base product. Each id must exist in variant_groups and appear once. A product with variant groups can’t have modifier_group_ids. Defaults to []. See Variants. | | variants | No | array | When this product is a variant: one entry per base, each { "product_id": base id, "variant_group_option_ids": [...] } with exactly one option from every group on the base. Defaults to []. | | recommendations_ids | No | array | Recommendation ids to surface on this product. Each id must exist in top-level recommendations. Defaults to []. | | recommendations | No | array | Per-recommendation display settings on this product. Defaults to []. |Each object in recommendations (inside pricing) links one catalog recommendation to the parent product:

Field	Required	Type	Description
`recommendation_id`	Yes	string	Must match an `id` from top-level `recommendations`.
`default_quantity`	No	number	Pre-selected quantity for the recommended product on this parent line. Defaults to `0`. Independent from `default_quantity` on `pricing.modifiers`.

Each object in modifiers configures one modifier group referenced in modifier_group_ids. It accepts the same pricing fields as the parent product, plus modifier-specific fields:

Field	Required	Type	Description

Example modifiers entry

{
  "modifier_group_id": "choose-drink",
  "minimum_quantity": 0,
  "maximum_quantity": 1,
  "is_tax_inclusive": true,
  "tax_rate": 0.15,
  "price": 0,
  "anchor_price": 0,
  "anchor_price_percentage": 0,
  "default_quantity": 1,
  "charge_above_quantity": 0,
  "display_type": "RADIO",
  "image_url": "https://cdn.example.com/cola-in-combo.jpg"
}

Field	Required	Description
`style`	Yes	Must be `"UBER_EATS"`.
`items`	Yes	Items and modifier options. Products and modifiers share this array. At least 1 entry. At most 1000.
`categories`	Yes	Category definitions with `entities` referencing item IDs. At least 1 entry. At most 100.
`modifier_groups`	No	Modifier group definitions. Omit or set `null` when no groups are used. At most 1000 when provided.
`recommendations`	No	Recommendation catalog. Same shape as `DEFAULT` after mapping. At most 1000 when provided. Defaults to `[]`.
`menus`	Yes	Menu definitions to create or update. At least 1 entry. At most 10.
`menu_type`	No	`MENU_TYPE_FULFILLMENT_DELIVERY`, `MENU_TYPE_FULFILLMENT_PICK_UP`, or `MENU_TYPE_FULFILLMENT_DINE_IN`. Defaults to delivery.
`display_options`	No	Store-level display settings such as `disable_item_instructions`.

Each object in menus uses the Uber Eats Menu shape:

Field	Required on create	Description
`id`	Yes	External menu identifier. Upsert key. Immutable after creation.
`title`	Yes	`MultiLanguageText` with a `translations` map (for example `en_us`).
`subtitle`	No	Optional subtitle as `MultiLanguageText`.
`service_availability`	Yes	Weekly availability with `day_of_week` and `time_periods` (`HH:MM`).
`category_ids`	Yes	Category IDs active while this menu is available.

MultiLanguageText

Localized strings wrap values in translations:

{
  "translations": {
    "en_us": "Coffee"
  }
}

items

Each item in the request body. Top-level products and modifier options are both items.

Field	Required	Type	Description

| id | Yes | string | Unique item identifier from your POS or RMS. | | title | Yes | object | Required MultiLanguageText. | | description | No | object | Optional MultiLanguageText. | | image_url | No | string | Public image URL. Optional. | | external_data | No | string | Partner metadata (max 1024 characters). Optional. | | price_info | No | object | Price in cents plus optional context overrides. See price_info. | | quantity_info | No | object | Quantity constraints and modifier-context overrides. Optional. | | modifier_group_ids | No | object | { "ids": [...] } with optional context overrides. Optional. | | tax_info | No | object | tax_rate, vat_rate_percentage, or mx_ieps_rate. Optional. | | suspension_info | No | object | Out-of-stock suspension rules. Optional. | | bundled_items | No | array | Items always included in a combo. Optional. | | dish_info | No | object | Dietary labels and classifications. Optional. | | visibility_info | No | object | Time windows when the item is visible. Optional. | | tax_label_info | No | object | Tax classification labels. Optional. | | product_info | No | object | GTIN, PLU, or merchant product identifiers. Optional. | | selling_info | No | object | Sold-by-weight or sold-by-unit configuration. Optional. |

Example item

{
  "id": "Coffee",
  "title": { "translations": { "en_us": "Coffee" } },
  "description": { "translations": { "en_us": "Deliciously roasted beans" } },
  "modifier_group_ids": { "ids": ["Add-milk"] },
  "price_info": { "price": 300 },
  "tax_info": { "tax_rate": 8 },
  "quantity_info": {}
}

Response

The endpoint returns asynchronously. Fire spark starts a background menu sync and responds immediately.

Status	When	Body
`201`	Sync accepted and queued	`{ "message": "Sync accepted: …" }` — counts of products, menus, categories, and modifier groups received
`202`	A sync is already running for the same store, channel, and brand	`{ "message": "Sync already in progress for this store/channel.", "runId": "…" }` — `runId` identifies the active workflow run
`409`	A sync is already in progress or completed for the same release and scope	`{ "message": "Sync already exists for this release and scope.", "menuSyncId": "…" }` — retry with the same `x-release-id` only if the prior sync `FAILED` or was `CANCELLED`

Treat 202 as success: the catalog is already being processed. Retry only after the current sync finishes or fails. Treat 409 as success when replaying a release that already completed successfully. If the prior sync for that release and scope FAILED or was CANCELLED, send the same x-release-id again.

Rate limits

GET and PUT /api/integrations/v1/menus share a limit of 30 requests per 10 seconds per merchant. The limit key is the merchant_id from your access token. Send one request at a time per merchant — wait for each response before starting the next. Do not parallelize menu upserts or reads for the same merchant. Every response includes rate limit headers so you know when you can send the next request:

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed per window (`30`)
`X-RateLimit-Reset`	Seconds until the current window resets (`10`)
`X-RateLimit-Remaining`	Requests remaining in the current window — present on `429` (`0`)
`Retry-After`	Seconds to wait before retrying — present only on `429` responses

When you exceed the limit, the API returns 429 Too Many Requests. Wait Retry-After seconds (or X-RateLimit-Reset) before sending another request for that merchant.

Error responses

| Status | Description | | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | | 400 | Validation error — invalid field values, missing required fields, or invalid weekly schedule shape. The body is { "error": "Invalid fields", "details": { "<path>": "<message>" } }. See Validation rules. | | 401 | Missing or invalid access token. | | 403 | Token does not include the menus:write scope. | | 409 | Referenced store, channel, or fulfillment does not exist for this merchant, or a sync already exists for this release and scope. | | 429 | Rate limit exceeded — wait for Retry-After / X-RateLimit-Reset before retrying. See Rate limits. | |

API Documentation

Endpoints

Guides

Resources

Headers

Query parameters

Sync styles

Request

Request body

Menu fields

Menu fields

MultiLanguageText

Response

Rate limits

Error responses

​Headers

​Query parameters

​Sync styles

​Request

​Request body

​Menu fields

​Menu fields

​MultiLanguageText

​Response

​Rate limits

​Error responses

Headers

Query parameters

Sync styles

Request

Request body

Menu fields

Menu fields

MultiLanguageText

Response

Rate limits

Error responses