Create a pricing policy

Creates a sell-side pricing policy (product_pricing_policies row) for a product. Each policy defines one qty-break tier on a pricing level or as a per-account override.

Required: product_id AND one of (pricing_level_id | account_id).

The combination of (product_id, pricing_level_id, account_id, variant_id, min_quantity) must be unique for active policies. Duplicate scope returns 422 duplicate_pricing_policy_for_scope.

Public field min_quantity maps to the canonical qty_break column. Hard cap: max 100 nested policy rules per request (returns 413 if exceeded).

Idempotent via Idempotency-Key header. Requires products:write scope.

POST /pricing-policies

Create a pricing policy

cURL

curl --request POST \
  --url https://api.arcuserp.com/v1/pricing-policies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product_id": "550e8400-e29b-41d4-a716-446655440000",
  "pricing_level_id": "660e8400-e29b-41d4-a716-446655440001",
  "min_quantity": 1,
  "sell_price": 49.99,
  "pricing_type": "regular"
}
'

201

{
  "data": {}
}

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

Body

application/json

product_id · string<uuid> · required

Product this policy applies to

pricing_level_id · string<uuid> | null

Pricing level UUID. Required if account_id not provided.

account_id · string<uuid> | null

Account-specific price override. Required if pricing_level_id not provided.

variant_id · string<uuid> | null

Scope to a specific variant (omit for product-wide)

pricing_type · enum<string> · default: regular

'regular' = absolute sell_price; 'multiplier' = sell_price derived from list_price * adjustment

Available options: regular, multiplier

min_quantity · integer · default: 1

Minimum order qty to activate this tier. Must be unique per scope.

Required range: x >= 1

sell_price · number<float> | null

Absolute sell price (pricing_type='regular')

list_price · number<float> | null

List price snapshot (pricing_type='multiplier')

adjustment · number<float> | null

Multiplier adjustment (pricing_type='multiplier')

margin_pct · number<float> | null

Margin percentage for reference

is_active · boolean · default: true

is_default · boolean · default: false

Mark as the default price for this product

external_source · string | null

Source system identifier (e.g. 'versa', 'bubble')

external_id · string | null

ID in the source system

migration_batch_id · string<uuid> | null

imported_at · string<date-time> | null

Response

201

application/json

Created pricing policy

data · object