Create Account Group

Beta

POST/v1/sales/account-groups

Idempotent with Idempotency-Key header. Learn more

Creates an account group.

Returns a conflict error if an account group with the same name already exists.

Permissions requiredValues:customer_groups:create

The role behind your API key or agent must grant every one of these permissions.

namestring

Display name of the account group.

Must be unique within your account; maximum 255 characters.

typestringenumValues:pricing_grouptype_group

How this account group will be used.

pricing_group: used for pricing rules, such as a "Preferred" group that receives a special discount.
type_group: used to categorize accounts, such as "Consumers" or "Distributors".

The type cannot be changed after creation.

commission_policyoptional stringenumValues:commission_appliedcommission_exempt

How sales commission applies to accounts in this group. Defaults to commission_exempt.

commission_applied: sales commission is calculated on orders from accounts in this group.
commission_exempt: orders from accounts in this group are exempt from commission.

freight_policyoptional stringenumValues:free_freightbilled_freight

How freight charges apply to orders from accounts in this group. Defaults to billed_freight.

free_freight: customers within this group will not have to pay for freight.
billed_freight: freight will be applied to any order within this account group, unless overridden elsewhere.

descriptionoptional string

Free-form description of the account group.

idstring

Account group ID.

objectstringenumValues:account_group

Resource type identifier.

typestringenumValues:pricing_grouptype_group

How this account group is used.

pricing_group: used for pricing rules, such as a "Preferred" group that receives a special discount.
type_group: used to categorize accounts, such as "Consumers" or "Distributors".

namestring

Display name of the account group.

Unique within the account.

descriptionstringnullable

Free-form description of the account group.

commission_policystringenumValues:commission_appliedcommission_exempt

How sales commission applies to accounts in this group.

commission_applied: sales commission is calculated on orders from accounts in this group.
commission_exempt: orders from accounts in this group are exempt from commission.

freight_policystringenumValues:free_freightbilled_freight

How freight charges apply to orders from accounts in this group.

free_freight: customers within this group will not have to pay for freight.
billed_freight: freight will be applied to any order within this account group, unless overridden elsewhere.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

201

Successful response for Create Account Group

Create Account Group

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const accountGroup = await client.sales.accountGroups.create({
  name: 'Wholesale Customers',
  type: 'type_group',
  commission_policy: 'commission_exempt',
  description: 'Customers who buy in bulk at wholesale pricing.',
  freight_policy: 'billed_freight',
});

console.log(accountGroup.id);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const accountGroup = await client.sales.accountGroups.create({
  name: 'Wholesale Customers',
  type: 'type_group',
  commission_policy: 'commission_exempt',
  description: 'Customers who buy in bulk at wholesale pricing.',
  freight_policy: 'billed_freight',
});

console.log(accountGroup.id);

201 example

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

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

Create Account Group

Authorization

Request Body

Returns

Responses