# Create a Column

Create a column by providing corresponding details for that type.


Endpoint: POST /1/columns/{datasetSlug}
Version: 1.0.0
Security: configuration_key

## Path parameters:

  - `datasetSlug` (string, required)
    The dataset slug.

## Request fields (application/json):

  - `key_name` (string, required)
    Name of the Column.
    Example: "my_column"

  - `type` (string)
    Type of data that the Column will contain. Histogram is in beta and only works in your Metrics dataset.
    Enum: "string", "float", "integer", "boolean", "histogram"

  - `description` (string)
    Column description.
    Example: "An integer column"

  - `hidden` (boolean)
    If , the column is excluded from autocomplete and raw data field lists.

## Response 201 fields (application/json):

  - `key_name` (string, required)
    Name of the Column.
    Example: "my_column"

  - `type` (string)
    Type of data that the Column will contain. Histogram is in beta and only works in your Metrics dataset.
    Enum: "string", "float", "integer", "boolean", "histogram"

  - `description` (string)
    Column description.
    Example: "An integer column"

  - `hidden` (boolean)
    If , the column is excluded from autocomplete and raw data field lists.

  - `id` (string)
    Unique identifier (ID), returned in response bodies.

  - `last_written` (string)
    ISO8601 formatted time the column was last written to (received event data).

  - `created_at` (string)
    ISO8601 formatted time the column was created.

  - `updated_at` (string)
    ISO8601 formatted time the column was updated.

## Response 400 fields (application/json):

  - `error` (string)

## Response 401 fields (application/json):

  - `error` (string)

## Response 403 fields (application/json):

  - `error` (string)

## Response 404 fields (application/json):

  - `error` (string)

## Response 409 fields (application/json):

  - `error` (string)

## Response 422 fields (application/problem+json):

  - `error` (string, required)

  - `status` (number, required)
    The HTTP status code of the error.

  - `type` (string, required)
    Type is a URI used to uniquely identify the type of error.

  - `title` (string, required)
    Title is a human-readable summary that explains the  of the problem.

  - `detail` (string)
    The general, human-readable error message.

  - `instance` (string)
    The unique identifier (ID) for this specific error.

  - `type_detail` (array)

  - `type_detail.field` (string)

  - `type_detail.code` (string)
    Enum: "invalid", "missing", "incorrect_type", "already_exists"

  - `type_detail.description` (string)

## Response 429 fields (application/json):

  - `error` (string)