POS API Reference
HomeSimpra POSSimpra InventoryCheck&Place
HomeSimpra POSSimpra InventoryCheck&Place
  1. Menu Items
  • Introduction
  • Overview
  • External API Action Scenarios
  • Checks
    • Get Checks
    • Add Discount to Check
    • Get Check
    • Add Payment to Check
    • Add Portal Plus Invoice Id to Check
    • Add Service Charge to Check
    • Add Service Message To Check
    • Cancel Check Item
    • Change Delivery Status
    • Create Check Item
    • Create Check
    • Remove Check Discount
    • Remove Check Service Charge
    • Unlock Check
    • Get Check Activities
    • Add Note to Check
  • Menu Items
    • Get Menu Items
      GET
    • Get Menu Item
      GET
    • Create Menu Items
      POST
    • Update Menu Items
      PATCH
    • Upsert Menu Items
      POST
    • Remove Menu Item Report Tags
      DELETE
  • Menu Item Definitions
    • Get Menu Item Definitions
  • Menu Item Groups
    • Get Menu Item Groups
  • Item Definitions
    • Get Item Definitions
    • Update Item Definitions
  • Condiments
    • Get Condiments
  • Condiment Groups
    • Get Condiment Groups
  • ComboMenus
    • Get ComboMenus
  • Custom Menu Items
    • Get Custom Menu Items
  • Customers
    • Get Customers
    • Add Customer
    • Update Customer
  • CustomerDiscounts
    • Get CustomerDiscounts
  • Employees
    • Get Employees
  • Properties
    • Get Properties
  • Accounting API
    • Get Enterprise
    • Get Property
    • Get Enterprises
    • Get Payment
    • Get Payments
    • Get Future Payments
    • Get Dealers
  • Cash Trackings
    • Get Cash Trackings
  • Currencies
    • Get Currencies
  • Current Accounts
    • Get Current Accounts
  • Daily Totals
    • Get Daily Totals
  • Devices
    • Get Devices
  • Discounts
    • Get Discounts
  • Imports
    • Get Imports
  • Opera Checks
    • Index
    • Mark As Sent Opera Pms Check
  • Payment Types
    • Get Payment Types
  • Price Lists
    • Get Price Lists
    • Get Price List
    • Create Price List
    • Create Price List with Sku
    • Update Price List
    • Delete Price List
    • Update Price List Items
    • Delete Price List Items
    • Update Price List Items with Sku
    • Delete Price List Items with Sku
  • Reason Payments
    • Get Reason Payments
  • Reasons
    • Get Reasons
  • Report Tags
    • Get Report Tags
    • Add Report Tag
    • Update Report Tag
  • Revenue Centers
    • Get Revenue Centers
  • Sales Channels
    • Get Sales Channels
  • Scheduled Jobs
    • Get Scheduled Job
    • Create Scheduled Job
    • Create Scheduled Job with Sku
    • Update Scheduled Job
    • Update Scheduled Job with Sku
  • Section Things
    • Get Section Things
  • Sections
    • Get Sections
  • Service Charges
    • Get Service Charges
  • Shifts
    • Get Shifts
    • Get Shift
  • Tables
    • Get Tables
  • Tags
    • Get Tags
  • Taxes
    • Get Taxes
  • Z Reports
    • Get Z Reports
  • Schemas
    • Schemas
      • PaginationMeta
      • Translation
      • Metafield
      • Error
      • Check
      • Customer
      • CustomerSummary
      • CustomerAccountDetail
      • MenuItem
      • Employee
      • Property
      • Enterprise
      • RevenueCenter
      • Table
      • SalesChannel
      • Delivery
      • CheckServiceCharge
      • CheckSummary
      • CheckDiscount
      • CheckPayment
      • CheckItem
      • CheckItemSummary
      • CheckOffer
      • Tax
      • Item
      • Device
      • Tag
      • ItemDefinition
      • CondimentGroup
      • DailyTotals
      • CreateCheckRequest
      • CreateCheckItemRequest
      • AddCheckPaymentRequest
      • AddCheckDiscountRequest
      • CreateCustomerRequest
      • CustomerAddressRequest
      • CustomerInvoiceRequest
      • UpdateCustomerRequest
      • CreateMenuItemRequest
      • UpdateMenuItemRequest
  1. Menu Items

Upsert Menu Items

Production
https://api.simpra.app
Production
https://api.simpra.app
POST
https://api.simpra.app
/apps/api/v1/menu_items/upsert
Last modified:2026-07-30 09:21:11
Scope: Enterprise
Body Parameters
FieldDefaultRequiredDescription
skuREQUIRED
nameREQUIRED
unit_typeREQUIRED
priceREQUIRED
tax_idREQUIRED
menu_item_group_idREQUIRED
price_list_id
barcodes[]
translations[]
receipe_menu_item
report_tag_ids[]
target_ids[]REQUIREDvalid resource ids: enterprise, property or revenue center
size_option_idfiltered size option items like target_ids
extra_fields[]REQUIREDThe requirement varies depending on the system configuration

Request

Authorization
Add parameter in header
Simpra-Access-Token
Example:
Simpra-Access-Token: ********************
Header Params

Responses

🟢200OK
OK
This response does not have a body.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.simpra.app/apps/api/v1/menu_items/upsert' \
--header 'Simpra-Access-Token: <api-key>' \
--header 'Content-Type: application\json'
Modified at 2026-07-30 09:21:11
Previous
Update Menu Items
Next
Remove Menu Item Report Tags
Built with