Create Product Line

Beta

POST/v1/catalog/product-lines

Idempotent with Idempotency-Key header. Learn more

Creates an account-owned product line.

include[]optional arrayenumValues:ownerowner.accountunit_group

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

namestring

Display name.

unit_group_idstring

Unit group ID.

commission_policystringenumValues:commission_appliedcommission_exempt

Commission policy.

freight_policystringenumValues:free_freightbilled_freight

Freight policy.

idstring

Product line ID.

objectstringenumValues:product_line

Resource type identifier.

namestring

Display name.

descriptionstringnullable

Description.

notesstringnullable

Notes.

commission_policystringenumValues:commission_appliedcommission_exempt

Commission policy.

freight_policystringenumValues:free_freightbilled_freight

Freight policy.

ownerobjectExpandablenullable

Owner.

objectstringenumValues:owner

Resource type identifier.

typestringenumValues:systemaccount

The owner type: "system" for platform defaults, "account" for account-owned resources.

accountobjectExpandablenullable

The account that owns this resource. null if the object is system-owned.

idstring

Account ID.

objectstringenumValues:account

Resource type identifier.

namestring

Display name.

default_billing_addressobjectnullable

Default billing address.

Always returned as null in this endpoint.

default_shipping_addressobjectnullable

Default shipping address.

Always returned as null in this endpoint.

brandingobjectnullable

Branding configuration.

Always returned as null in this endpoint.

portalobjectnullable

Portal configuration.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

unit_groupobjectExpandablenullable

Unit group.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last-updated timestamp.

Responses

201

Successful response for Create Product Line

Create Product Line

curl API_HOST/v1/catalog/product-lines \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Industrial Fasteners",
  "unit_group_id": "ug_01jm4r6700f8nwq3v5hx2d9ktp",
  "commission_policy": "commission_exempt",
  "freight_policy": "billed_freight"
}'

curl API_HOST/v1/catalog/product-lines \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Industrial Fasteners",
  "unit_group_id": "ug_01jm4r6700f8nwq3v5hx2d9ktp",
  "commission_policy": "commission_exempt",
  "freight_policy": "billed_freight"
}'

201 example

{
  "id": "pl_01jm4r6700f8nwq3v5hx2d9ktp",
  "object": "product_line",
  "name": "Industrial Fasteners",
  "description": null,
  "notes": null,
  "commission_policy": "commission_exempt",
  "freight_policy": "billed_freight",
  "owner": {
    "object": "owner",
    "type": "system",
    "account": null
  },
  "unit_group": null,
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "pl_01jm4r6700f8nwq3v5hx2d9ktp",
  "object": "product_line",
  "name": "Industrial Fasteners",
  "description": null,
  "notes": null,
  "commission_policy": "commission_exempt",
  "freight_policy": "billed_freight",
  "owner": {
    "object": "owner",
    "type": "system",
    "account": null
  },
  "unit_group": null,
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Create Product Line

Query Parameters

Request Body

Returns

Responses