# 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

## Security:

  - `Bearer` (unknown)
    http Bearer

## Query parameters:

  - `environmentId` (string)

## Request body:

  - `application/json, text/json, application/*+json` (unknown)
    Input data containing name and the description of the site collection

## 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)
    A short, meaningful name for the collection.
Example value: Skate Brand Websites
    Example: Skate Brand Websites

  - `description` (string)
    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:

  - `200` (unknown)
    Success

## Response 200 fields (application/json):

  - `handle` (string)

## Response 400:

  - `400` (unknown)
    Bad request

## Response 400 fields (application/json):

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

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

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

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

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

