POS API Reference
HomeSimpra POSSimpra InventoryCheck&Place
HomeSimpra POSSimpra InventoryCheck&Place
  1. Condiments
  • 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 Menu Item
    • Create Menu Items
    • Update Menu Items
    • Upsert Menu Items
    • Remove Menu Item Report Tags
  • 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
      GET
    • Create Condiments
      POST
    • Update Condiments
      PATCH
    • Upsert Condiments
      POST
  • 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. Condiments

Create Condiments

Developing
Production
https://api.simpra.app
Production
https://api.simpra.app
POST
https://api.simpra.app
/apps/api/v1/condiments
Last modified:2026-09-29 11:49:01
Scope: Enterprise
Need enterprise token
Body Parameters
FieldDefaultRequiredDescription
nameREQUIRED when translations empty
condiment_group_idREQUIREDAn active condiment group of the enterprise
priceREQUIRED
skuMust be unique across menu items and condiments
activetrue
printabletrue
tax_id
price_list_id
translations[]
property_idsall propertiesItem definitions are created for these properties and their revenue centers
report_tag_ids[]
extra_fields[]REQUIREDShared with menu items. The requirement varies depending on the system configuration
Errors (HTTP 422)
MessageReason
condiment_group_id requiredcondiment_group_id is missing
Invalid condiment_group_idNot an active condiment group of the enterprise
Invalid tax_idNot an active tax of the enterprise
Invalid price_list_idNot a price list of the enterprise
Invalid report_tag_idsAt least one id is not a report tag of the enterprise
Invalid extra field keysAn extra field has no key or no value
Invalid extra field valuesAn extra field has an empty key or value
Condiment API is not enabledThe endpoint is not enabled for this environment
Name can't be blankname is missing and no translations are sent
Price can't be blankprice is missing
Validation messages are translated by the Accept-Language header and joined into one message when several fields fail, for example Name can't be blank and Price can't be blank.

Request

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

Body Params application/json

Examples

Responses

🟢200OK
application/json
OK
Bodyapplication/json

🟠422Invalid tax_id
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.simpra.app/apps/api/v1/condiments' \
--header 'Accept-Language: en' \
--header 'Simpra-Access-Token: <api-key>' \
--header 'Content-Type: application\json' \
--data '{
    "name": "Ekstra Peynir",
    "sku": "CND-001",
    "condiment_group_id": "6f3b2c10-8d4e-4a19-9f21-0b7c5e3a1d44",
    "price": 25,
    "printable": true,
    "tax_id": "b1e7a904-3c62-4f88-8d15-7a92c4e60b33",
    "price_list_id": "0d5f1a77-2b83-4c90-a6e4-9f31d8b02c56",
    "report_tag_ids": [
        "e4c8b210-59a3-4d77-b8f1-2c60a9e34d85"
    ],
    "property_ids": [
        "a7d3f612-4e85-4b20-9c71-6f08b2d54e19"
    ],
    "translations": [
        {
            "locale": "tr",
            "text": "Ekstra Peynir"
        },
        {
            "locale": "en",
            "text": "Extra Cheese"
        }
    ],
    "extra_fields": [
        {
            "key": "ErpKodu",
            "value": "10045"
        }
    ]
}'
Response Response Example
200 - Success Example
{
    "condiment": {
        "id": "9c2e5b81-7a34-4f06-b9d2-3e81c7a40f92"
    }
}
Modified at 2026-09-29 11:49:01
Previous
Get Condiments
Next
Update Condiments
Built with