---
title: "Create a commerce item"
method: POST
path: "/commerce/items"
tags: ["Commerce"]
---

# Create a commerce item

`POST /commerce/items`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/commerce/items`
- Auth: HTTP bearer

Requires `commerce:items:write`.

## Request body

- CommerceItemCreateRequest
  - `name` string, required
  - `description` string
  - `amountMinor` integer, required
  - `currency` string
  - `active` boolean
  - `allowQuantity` boolean
  - `minQuantity` integer
  - `maxQuantity` integer
  - `fields` CommerceItemFieldInput[]
    - `key` string
    - `label` string, required
    - `type` 'text' | 'number' | 'email' | 'phone' | 'date' | 'select', required
    - `required` boolean, required
    - `options` string[]

## Response `201`

Commerce item created

- CommerceItemResponse
  - `item` CommerceItem, required
    - `itemId` string, required
    - `tenantId` string, required
    - `name` string, required
    - `description` string
    - `amountMinor` integer, required
    - `currency` string, required
    - `active` boolean, required
    - `scope` 'global' | 'property', required
    - `propertyId` string
    - `allowQuantity` boolean, required
    - `minQuantity` integer, required
    - `maxQuantity` integer, required
    - `fields` CommerceItemField[], required
      - `key` string, required
      - `label` string, required
      - `type` 'text' | 'number' | 'email' | 'phone' | 'date' | 'select', required
      - `required` boolean, required
      - `options` string[]
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)