# Create or update a buyer group

If an object with the same ID already exists, it will be overwritten.

Endpoint: PUT /buyergroups/{buyerGroupID}
Version: 1.0.457.36910
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2 scopes: FullAccess, BuyerAdmin

## Path parameters:

  - `buyerGroupID` (string, required)
    ID of the buyer group.

## Request fields (application/json):

  - `ID` (string)

  - `Name` (string)

  - `Description` (string)

  - `DefaultCatalogID` (string)
    If null at the individual buyer level, and buyer is a member of this group, buyer inherits this default catalog.

  - `xp` (object)

## Response 200:

  - `200` (unknown)
    If an object with the same ID already exists, it will be overwritten.

## Response 200 fields (application/json):

  - `ID` (string)

  - `Name` (string)

  - `Description` (string)

  - `DefaultCatalogID` (string)
    If null at the individual buyer level, and buyer is a member of this group, buyer inherits this default catalog.

  - `xp` (object)

## Response 4XX:

  - `4XX` (unknown)
    Expected errors range from 400-409. Anything in the 5XX range indicates a server issue and should be reported to support.

## Response 4XX fields (application/json):

  - `StatusCode` (integer)
    Example: 404

  - `ErrorCode` (string)
    Example: NotFoundError

  - `Message` (string)
    Example: Object not found

  - `Data` (object)
    Example: {"ObjectType":"","ObjectID":""}