Skip to main content
POST
/
pricing-policies
Create a pricing policy
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"
}
'
{
  "data": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.arcuserp.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Created pricing policy

​
data
object