---
title: "Create Item"
method: POST
path: "/items"
tags: ["Items"]
---

# Create Item

`POST /items`

Create an **Item**. Items require two **Users**, a buyer and a seller. The `buyer_id` and `seller_id` are your unique user identifiers.

## Request body

- ItemRequestBody
  - `id` string, required — Unique ID that can be generated by the platform. Cannot contain '.' or '/' characters. Contact Assembly support if you want item IDs to be generated automatically.
  - `name` string, required — A name for the item
  - `amount` integer, required — The cost in cents
  - `currency` string — [ISO 4217 alpha-3](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) currency code. This is an optional field and if not provided, the item will be created with the default currency of the marketplace.
  - `payment_type` integer, required — Payment type: 2. Express
  - `buyer_id` string, required — Marketplace / Pltform buyer ID
  - `seller_id` string, required — Marketplace / Platform Seller ID
  - `fee_ids` string — A comma separated list of fee IDs to apply
  - `description` string — A description of the item
  - `buyer_url` string — Link for the buyer CTA (Call To Action)
  - `seller_url` string — Link for the seller CTA (Call To Action)
  - `tax_invoice` boolean — Toggle to generate tax invoice once Item is complete
  - `custom_descriptor` string — When `custom_descriptors` are enabled, this is the information to appear on credit card and direct debit statements.

## Response `201`

OK

- SingleItem
  - `items` Item
    - `id` string, required
    - `name` string, required
    - `description` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `state` 'pending' | 'payment_required' | 'wire_pending' | 'payment_pending' | 'payment_held' | 'payment_authorized' | 'void_pending' | 'voided' | 'fraud_hold' | 'payment_deposited' | 'work_completed' | 'problem_flagged' | 'problem_resolve_requested' | 'problem_escalated' | 'completed' | 'cancelled' | 'refunded' | 'refund_pending' | 'refund_flagged' | 'off_platform_refunded' | 'partial_completed' | 'partial_paid' | 'off_platform_chargedback'
    - `status` 22000 | 22100 | 22110 | 22150 | 22175 | 22180 | 22185 | 22195 | 22190 | 22200 | 22300 | 22400 | 22410 | 22420 | 22500 | 22575 | 22600 | 22610 | 22650 | 22670 | 22700 | 22800 | 22680
    - `amount` integer, required
    - `payment_type_id` integer
    - `currency` string
    - `buyer_name` string
    - `buyer_email` string, email
    - `buyer_country` string
    - `seller_name` string
    - `seller_email` string, email
    - `seller_country` string, email
    - `tds_check_state` string, email
    - `batch_state` string
    - `invoice_url` string
    - `payout_descriptor` string
    - `remaining_amount` integer
    - `requested_release_amount` integer
    - `custom_descriptor` string
    - `net_amount` integer
    - `chargedback_amount` integer
    - `refunded_amount` integer
    - `released_amount` integer
    - `buyer_fees` integer
    - `seller_fees` integer
    - `credit_card_fee` integer
    - `paypal_fee` integer
    - `seller_url` string
    - `buyer_url` string
    - `direct_debit_fee` integer
    - `due_date` string, date, nullable
    - `pending_release_amount` integer
    - `dynamic_descriptor` string
    - `deposit_reference` string
    - `promisepay_fee` integer
    - `total_outstanding` integer
    - `total_amount` integer
    - `payment_method` string
    - `payment_credit_card_enabled` boolean
    - `payment_direct_debit_enabled` boolean
    - `related` object
      - `buyers` string
      - `sellers` string
    - `links` object
      - `self` string
      - `buyers` string
      - `sellers` string
      - `status` string
      - `fees` string
      - `transactions` string
      - `batch_transactions` string
      - `wire_details` string
      - `bpay_details` string
      - `tds_checks` string

---

[API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/versions/60b528b2e015/schema)