Update Account Group

Beta

PATCH/v1/sales/account-groups/{id}

Idempotent with Idempotency-Key header. Learn more

Partially updates an account group.

Only the provided fields are changed. The account group's type cannot be changed after creation.

Permissions requiredValues:customer_groups:update

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

idstring

Account group ID.

nameoptional string

Display name of the account group.

Must be unique within your account; maximum 255 characters.

descriptionoptional stringnullable

Free-form description of the account group. Send null to clear.

commission_policyoptional stringenumValues: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_policyoptional stringenumValues: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.

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

200

Successful response for Update Account Group

Update 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.update('acgp_018e88072d1320808dc979cfac', {
  commission_policy: 'commission_exempt',
  description: 'Customers who buy in bulk at wholesale pricing.',
  freight_policy: 'billed_freight',
  name: 'Updated Wholesale Customers',
});

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.update('acgp_018e88072d1320808dc979cfac', {
  commission_policy: 'commission_exempt',
  description: 'Customers who buy in bulk at wholesale pricing.',
  freight_policy: 'billed_freight',
  name: 'Updated Wholesale Customers',
});

console.log(accountGroup.id);

200 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"
}

Update Account Group

Authorization

Path Parameters

Request Body

Returns

Responses