Create Account Group

Beta

POST/v1/sales/account-groups

Idempotent with Idempotency-Key header. Learn more

Creates an account group.

namestring

Display name.

typestringenumValues:pricing_grouptype_group

Account group type.

commission_policyoptional stringenumValues:commission_appliedcommission_exempt

Commission policy. Defaults to commission_exempt.

freight_policyoptional stringenumValues:free_freightbilled_freight

Freight policy. Defaults to billed_freight.

descriptionoptional string

Description.

idstring

Account group ID.

objectstringenumValues:account_group

Resource type identifier.

namestring

Display name.

descriptionstringnullable

Description.

commission_policystringenumValues:commission_appliedcommission_exempt

Commission policy.

freight_policystringenumValues:free_freightbilled_freight

Freight policy.

typestringenumValues:pricing_grouptype_group

Account group type.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

201

Successful response for Create Account Group

Create Account Group

curl API_HOST/v1/sales/account-groups \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Wholesale Customers",
  "type": "type_group"
}'

curl API_HOST/v1/sales/account-groups \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Wholesale Customers",
  "type": "type_group"
}'

201 example

{
  "id": "acgp_01jm4r6700f8nwq3v5hx2d9ktp",
  "object": "account_group",
  "name": "Wholesale Customers",
  "description": null,
  "commission_policy": "commission_applied",
  "freight_policy": "billed_freight",
  "type": "type_group",
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "acgp_01jm4r6700f8nwq3v5hx2d9ktp",
  "object": "account_group",
  "name": "Wholesale Customers",
  "description": null,
  "commission_policy": "commission_applied",
  "freight_policy": "billed_freight",
  "type": "type_group",
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Create Account Group

Request Body

Returns

Responses