# Create a site collection

Creates a collection by specifying a name and, optionally, a display name and description.

Endpoint: POST /api/v1/collections
Version: v1
Security: Bearer

## Query parameters:

  - `environmentId` (string)

## Request fields (application/json):

  - `name` (string, required)
    The unique system name of the new collection.
Example value: skate-brand-sites
    Example: "skate-brand-sites"

  - `displayName` (string,null)
    A short, meaningful name for the collection.
Example value: Skate Brand Websites
    Example: "Skate Brand Websites"

  - `description` (string,null)
    A longer, more detailed description of the collection.
Example value: Collection for all Skate Park brand websites.
    Example: "Collection for all Skate Park brand websites."

## Response 200 fields (application/json):

  - `handle` (string,null)

## Response 400 fields (application/json):

  - `type` (string,null)
    The type of the error response entity.

  - `title` (string,null)
    The title of the error response entity.

  - `status` (integer,null)
    The response status code.

  - `detail` (string,null)
    A detailed explanation, specific to this occurrence of the problem.

  - `instance` (string,null)
    If available, a URI reference that identifies the specific occurrence of the problem.