# Create a buyer

Endpoint: POST /buyers
Version: 1.0.450.36533
Security: OAuth2

## Request fields (application/json):

  - `Name` (string, required)

  - `ID` (string)

  - `GroupID` (string)

  - `DefaultCatalogID` (string)
    Allows filtering products by category without explicitly providing a CatalogID. Inherits from buyer group if not specified. If neither is specified when buyer is created, a new catalog is automatically created.

  - `Active` (boolean)
    If false, all user authentication is blocked.

  - `xp` (object)
    Example: {}

## Response 201 fields (application/json):

  - `ID` (string)

  - `Name` (string)

  - `GroupID` (string)

  - `DefaultCatalogID` (string)
    Allows filtering products by category without explicitly providing a CatalogID. Inherits from buyer group if not specified. If neither is specified when buyer is created, a new catalog is automatically created.

  - `Active` (boolean)
    If false, all user authentication is blocked.

  - `DateCreated` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `xp` (object)
    Example: {}

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

  - `StatusCode` (integer)
    Example: "404"

  - `ErrorCode` (string)
    Example: "NotFoundError"

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

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