Skip to main content
POST
Create Product Group
Connector tool: create_product_group Creates an empty group. Names are unique on your account, ignoring case: a name already in use returns 409. Add products with Update group products. Call it with your API key, or with a Subtotal: For Business OAuth token that includes product_groups:write. A token without it receives 403 insufficient_scope. Partner app tokens don’t include it.

Authorizations

Authorization
string
header
required

Partner OAuth: send Authorization: Bearer <access_token>, an OAuth access token from Subtotal's authorization server with the scope this endpoint needs.

Body

application/json

Product group name for create or rename. Surrounding whitespace is stripped, so a blank name is rejected.

name
string
required
Required string length: 1 - 60

Response

Successful Response

product_group_id
string
required
name
string
required
product_count
integer
required
creation_date
string<date-time>
required