Create Item | propelone | Documentation

Request

This endpoint expects a multipart form.

skustringRequired

Optional: SKU code - max 100 chars - “HVAC-TUNE-001”

codestringRequired

Optional: Internal code - max 100 chars - “ACTUNE”

coststringRequired

Optional: Cost/COGS - numeric, min 0 - “75.00”

namestringRequired

Required: Item name - max 255 chars - “AC Tune-Up”

statusstringRequired

Optional: Item status - active|inactive|draft - default active

item_typestringRequired

base_pricestringRequired

Required: Base price - numeric, min 0 - “149.99”

is_taxablestringRequired

Optional: Whether item is taxable - 0|1 - default true

sort_orderstringRequired

Optional: Display sort order - numeric

descriptionstringRequired

Optional: Item description

markup_typestringRequired

Optional: Markup calculation type - cost_plus_percentage|cost_plus_fixed|target_margin

effective_tostringRequired

Optional: Price effective to date - YYYY-MM-DD, must be after effective_from

markup_valuestringRequired

Optional: Markup value - numeric

member_pricestringRequired

Optional: Fixed member price - numeric, min 0

pricing_unitstringRequired

tax_categorystringRequired

Optional: Tax category override

effective_fromstringRequired

Optional: Price effective from date - YYYY-MM-DD

product_info_urlstringRequired

Optional: Manufacturer product page or spec sheet URL - used in work recommendation education mode

product_video_urlstringRequired

Optional: Manufacturer product video URL (YouTube, Vimeo, or direct link) - used in work recommendation education mode

tax_rate_overridestringRequired

Optional: Tax rate override - numeric, 0-100

member_discount_pctstringRequired

Optional: Member discount percentage - numeric, 0-100

member_pricing_typestringRequired

Optional: Member pricing type - fixed|percentage_discount

emergency_multiplierstringRequired

Optional: Emergency price multiplier - numeric, min 1 - “1.5”

pricebook_category_idstringRequired

Optional: Category ID - must exist in pricebook_categories

Response

Successful response

1	curl -X POST https://https//https/pricebook/items \
2	-H "{{tenant_key_name}}: {{tenant_key_value1}}\|{{tenant_key_value2}}" \
3	-H "Content-Type: multipart/form-data" \
4	-F sku="HVAC-TUNE-001" \
5	-F code="ACTUNE" \
6	-F cost="75.00" \
7	-F name="AC Tune-Up" \
8	-F status="active" \
9	-F item_type="service_bundle" \
10	-F base_price="149.99" \
11	-F is_taxable="1" \
12	-F sort_order="10" \
13	-F description="Comprehensive air conditioning system tune-up including inspection and cleaning." \
14	-F markup_type="cost_plus_percentage" \
15	-F effective_to="2025-12-31" \
16	-F markup_value="20" \
17	-F member_price="129.99" \
18	-F pricing_unit="flat_rate" \
19	-F tax_category="standard" \
20	-F effective_from="2024-01-01" \
21	-F product_info_url="https://https//manufacturer.com/products/ac-tune-up-specs" \
22	-F product_video_url="https://https//www.youtube.com/watch?v=abcd1234" \
23	-F tax_rate_override="8.25" \
24	-F member_discount_pct="15" \
25	-F member_pricing_type="percentage_discount" \
26	-F emergency_multiplier="1.5" \
27	-F pricebook_category_id="cat-00123"

Headers

Request

Response