Upsert a company group
Creates or renames a single company group in one endpoint. Pass id to rename the matching existing group; omit id to create a new one. A create responds 201, an update responds 200. Company groups are the labels you use to organize your business relationships (customers and vendors); price tiers can target or exclude companies by group.
name is required and must be unique within your company — reusing a name already taken by another of your groups is rejected with a 400. On update, name fully replaces the stored name; there are no other editable fields, so this endpoint only ever sets the group's name.
Renaming a group does not change its ID, so any price tier that already targets or excludes this group keeps doing so under the new name. Creating a group does not attach it to any company relationship — membership is managed separately.
Required permission: settings_permissions_company_relationship_groups.
Request body
Response
The updated company group
Changes
No recorded changes to this endpoint across all 1 revision of this API.