Create a product

Atomic-create endpoint — accepts the complete nested resource graph in one transactional POST. If any child fails to write, the entire request rolls back. The response includes every child hydrated inline (variants, pricing, components, vendors) so no follow-up GET is required.

The product_type discriminator controls which nested children are accepted:

• physical / service: accepts pricing[] and vendors[]
• kit / box: accepts components[], pricing[], and vendors[]
• variant_parent: accepts variants[] (each variant may include its own components[], pricing[], vendors[]), plus top-level pricing[] and vendors[]

Pricing tiers: each pricing[] element uses min_quantity (the public-API key; internally mapped to qty_break) to define the minimum order quantity that activates the tier. Use a unique min_quantity within the same pricing_level_id scope to express qty-break discounts.

Vendor cost tiers: each vendors[] element may carry a purchase_policies[] array of vendor cost tiers (product_purchase_policies) — the per-quantity price that vendor charges. These are wired atomically alongside the vendor relationship.

Guide: https://arcuserp.mintlify.app/guides/creating-products-kits-variants

POST /products

Create a product

cURL

curl --request POST \
  --url https://api.arcuserp.com/v1/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Riser Kit",
  "product_type": "variant_parent",
  "description": "Modular riser kit with dome or flat options",
  "variants": [
    {
      "title": "Dome Riser Kit",
      "sku": "RISER-DOME",
      "product_type": "kit",
      "components": [
        {
          "component_product_id": "prod_stone_uuid",
          "quantity": 2
        },
        {
          "component_product_id": "prod_dome_lid_uuid",
          "quantity": 1
        }
      ],
      "pricing": [
        {
          "pricing_level_id": "pl_default_uuid",
          "min_quantity": 1,
          "list_price": 49.99
        },
        {
          "pricing_level_id": "pl_default_uuid",
          "min_quantity": 5,
          "list_price": 44.99
        },
        {
          "pricing_level_id": "pl_default_uuid",
          "min_quantity": 10,
          "list_price": 39.99
        }
      ],
      "vendors": [
        {
          "vendor_id": "acct_acme_uuid",
          "vendor_sku": "RD-001",
          "default_unit_cost": 18
        }
      ]
    },
    {
      "title": "Flat Riser Kit",
      "sku": "RISER-FLAT",
      "product_type": "kit",
      "components": [
        {
          "component_product_id": "prod_stone_uuid",
          "quantity": 2
        },
        {
          "component_product_id": "prod_flat_lid_uuid",
          "quantity": 1
        }
      ],
      "pricing": [
        {
          "pricing_level_id": "pl_default_uuid",
          "min_quantity": 1,
          "list_price": 44.99
        },
        {
          "pricing_level_id": "pl_default_uuid",
          "min_quantity": 5,
          "list_price": 39.99
        },
        {
          "pricing_level_id": "pl_default_uuid",
          "min_quantity": 10,
          "list_price": 34.99
        }
      ]
    }
  ],
  "vendors": [
    {
      "vendor_id": "acct_acme_uuid",
      "vendor_sku": "RISER-PARENT",
      "default_unit_cost": 15,
      "purchase_policies": [
        {
          "qty_break": 1,
          "purchase_price": 15,
          "is_default": true
        },
        {
          "qty_break": 100,
          "purchase_price": 13.5
        }
      ]
    }
  ]
}
'

201

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "object": "product",
    "entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "description": "<string>",
    "sku": "<string>",
    "part_number": "<string>",
    "barcode": "<string>",
    "category_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "vendor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "list_price": 123,
    "cost": 123,
    "is_active": true,
    "is_sellable": true,
    "is_serialized": true,
    "charge_tax": true,
    "track_inventory": true,
    "weight": 123,
    "weight_uom": "<string>",
    "length": 123,
    "width": 123,
    "height": 123,
    "length_uom": "<string>",
    "quantity_uom": "<string>",
    "product_tax_code": "<string>",
    "reorder_point": 123,
    "reorder_qty": 123,
    "safety_stock": 123,
    "packaging_classification": "over_box",
    "has_variants": true,
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization · string · header · required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.

Headers

Idempotency-Key · string

Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.

Maximum string length: 255

Body

application/json

title · string · required

Example:

"Riser Kit"

product_type · enum<string> · required

Available options: physical, kit, box, service, variant_parent

Example:

"variant_parent"

description · string

Example:

"Modular riser kit with dome or flat options"

sku · string

list_price · number

packaging_classification · enum<string> · default: over_box

Amazon-FBA packaging classification. Defaults to over_box (standard Mighty path). Set to sioc or sipp for single-item ship-ready packaging (label tapes on product, no over-box, no prep -- cannot co-pack). Set to prep_free when an over-box is still required but the prep step is skipped (no bubble wrap / bagging / labels-on-product). Mighty reads this on every pack-order call. See the Product schema for full enum semantics.

Available options: over_box, sioc, sipp, prep_free

Example:

"over_box"

components · object[]

Kit/box component assemblies (product_type=kit or box only). Each element references a component product and the quantity required to build one unit of this kit.

Show child attributes

variants · object[]

Inline variants (product_type=variant_parent only). Each variant can itself carry kit components[], qty-break pricing[], and vendors[] that are wired atomically in the same transaction.

Show child attributes

pricing · object[]

Sell-side pricing policies for the parent product (any product_type). Each element defines one qty-break tier on a pricing level. Use min_quantity to set the minimum order quantity that activates this tier (maps to qty_break internally). All money fields are returned as JS numbers (float).

Show child attributes

vendors · object[]

Vendor relationships on the parent product (any product_type)

Show child attributes

Response

201

application/json

Product created

data · object

Arcus ERP product (physical/kit/box/service/variant_parent).

Show child attributes