> ## Documentation Index
> Fetch the complete documentation index at: https://help.vori.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an item modifier

> Create an item modifier



## OpenAPI

````yaml /api/openapi.json post /v1/item-modifiers
openapi: 3.0.0
info:
  title: Vori API
  description: ''
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.vori.com
    description: production
security: []
tags: []
paths:
  /v1/item-modifiers:
    post:
      tags:
        - Item modifiers
      summary: Create an item modifier
      description: Create an item modifier
      operationId: createItemModifier
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateItemModifierRequest'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ItemModifier'
        '400':
          description: ''
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ConflictingPropertyValuesError'
                  - $ref: '#/components/schemas/InvalidStoreError'
        '403':
          description: ''
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/InsufficientPermissionsError'
                  - $ref: '#/components/schemas/NoBannerAssociationError'
      security:
        - bearer: []
components:
  schemas:
    CreateItemModifierRequest:
      type: object
      properties:
        name:
          type: string
          description: Human-readable item modifier name.
        price_tag_label:
          nullable: true
          description: >-
            Optional shelf-tag classification for bottle deposits or container
            redemption value.
          allOf:
            - $ref: '#/components/schemas/PriceTagModifier'
        store_id:
          type: string
          description: ID of the store the item modifier belongs to.
          pattern: ^[0-9]+$
        tax_behavior:
          description: >-
            Whether the modifier is excluded from tax or inherits the product
            tax behavior.
          allOf:
            - $ref: '#/components/schemas/ItemModifierTaxBehavior'
        type:
          description: Business purpose of the item modifier.
          allOf:
            - $ref: '#/components/schemas/ItemModifierType'
        value:
          type: string
          description: >-
            Monetary value of the modifier as a decimal string in major/minor
            currency units.
          pattern: ^[0-9]+(\.[0-9]+)?$
          example: '199.99'
      required:
        - name
        - store_id
        - type
        - value
    ItemModifier:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the record.
        created_at:
          type: string
          description: When the record was created.
          format: date-time
        name:
          type: string
          description: Human-readable item modifier name.
        price_tag_label:
          nullable: true
          description: >-
            Optional shelf-tag classification for bottle deposits or container
            redemption value.
          allOf:
            - $ref: '#/components/schemas/PriceTagModifier'
        store_id:
          type: string
          description: ID of the store the item modifier belongs to.
          pattern: ^[0-9]+$
        tax_behavior:
          description: >-
            Whether the modifier is excluded from tax or inherits the product
            tax behavior.
          allOf:
            - $ref: '#/components/schemas/ItemModifierTaxBehavior'
        type:
          description: Business purpose of the item modifier.
          allOf:
            - $ref: '#/components/schemas/ItemModifierType'
        updated_at:
          type: string
          description: When the record was last changed.
          format: date-time
        value:
          type: string
          description: >-
            Monetary value of the modifier as a decimal string in major/minor
            currency units.
          pattern: ^[0-9]+(\.[0-9]+)?$
          example: '199.99'
      description: A charge added alongside a product's price, such as a bottle deposit.
      required:
        - id
        - created_at
        - name
        - price_tag_label
        - store_id
        - tax_behavior
        - type
        - updated_at
        - value
    ConflictingPropertyValuesError:
      type: object
      properties:
        error_code:
          type: string
          enum:
            - conflicting_property_values
      required:
        - error_code
    InvalidStoreError:
      type: object
      properties:
        error_code:
          type: string
          enum:
            - invalid_store
      required:
        - error_code
    InsufficientPermissionsError:
      type: object
      properties:
        error_code:
          type: string
          enum:
            - insufficient_permissions
        error_details:
          $ref: '#/components/schemas/InsufficientPermissionsErrorDetails'
      required:
        - error_code
        - error_details
    NoBannerAssociationError:
      type: object
      properties:
        error_code:
          type: string
          enum:
            - no_banner_association
      required:
        - error_code
    PriceTagModifier:
      type: string
      enum:
        - BOTTLE_DEPOSIT
        - CRV
    ItemModifierTaxBehavior:
      type: string
      enum:
        - EXCLUDE
        - INHERIT_FROM_STORE_PRODUCT
    ItemModifierType:
      type: string
      enum:
        - bottle_deposit
        - custom
        - food_modifier
    InsufficientPermissionsErrorDetails:
      type: object
      properties:
        action:
          allOf:
            - $ref: '#/components/schemas/Action'
        resource:
          allOf:
            - $ref: '#/components/schemas/Resource'
      required:
        - action
        - resource
    Action:
      type: string
      enum:
        - '*'
        - cancel
        - check_in
        - create
        - delete
        - read
        - record_events
        - refund
        - restart
        - update
        - void
    Resource:
      type: string
      enum:
        - '*'
        - accounting_integration
        - agent_chats
        - api_clients
        - asynchronous_tasks
        - banners
        - blackhawk_transactions
        - capabilities
        - coupons
        - custom_quick_actions
        - datacap_transactions
        - departments
        - discounts
        - ditto_auth_tokens
        - edge_agents
        - electronic_shelf_labels
        - employees
        - files
        - food_modifiers
        - gift_cards
        - gl_code_mappings
        - house_accounts
        - inventory
        - inventory_sessions
        - invoices
        - item_modifiers
        - label_dimension_sets
        - label_sheet_profiles
        - label_stock_products
        - lanes
        - loyalty_bonuses
        - loyalty_campaigns
        - loyalty_rewards
        - notification_templates
        - offers
        - order_guides
        - pos_banner_configurations
        - pos_orders
        - pos_tills
        - price_tags
        - product_ranges
        - products
        - promotions
        - purchase_orders
        - receiving
        - reporting
        - revision_sessions
        - revisions
        - roles
        - shopper_tags
        - shoppers
        - store_product_inventory_counts
        - store_product_lots
        - store_product_rules
        - store_product_tag_templates
        - store_snap_incentive_program_coupons
        - store_vendor_merge_requests
        - store_vendor_product_merge_requests
        - store_vendor_products
        - store_vendors
        - stores
        - tag_printings
        - tag_template_presets
        - tag_templates
        - tax_rates
        - users
        - variable_weights
        - vendor_merge_requests
        - vendor_product_merge_requests
        - vendors
        - wallet_payments
        - wic_products
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

## Related topics

- [Create and Manage Item Modifiers](/bottle-deposits-tares-and-taxes/create-and-manage-item-modifiers.md)
- [Delete an item modifier](/api-reference/item-modifiers/delete-an-item-modifier.md)
- [Retrieve an item modifier](/api-reference/item-modifiers/retrieve-an-item-modifier.md)