Use this tool to add a new column to an existing board. You must specify the column type (e.g. status, date, numbers, people) and a title. For column types that require configuration—such as status (label definitions) or dropdown (option lists)—provide a JSON string in columnSettings.

🚧
Best practice: Before passing columnSettings, call get_column_type_info with fetchMode: "schema" for the target column type. This returns the exact JSON schema for that type's settings so you can construct a valid configuration.

Parameters

Parameter	Type	Required	Description
boardId	`number`	Yes	The ID of the board to add the column to.
columnType	`string`	Yes	The type of column to create. Supported types include: `auto_number`, `board_relation`, `checkbox`, `date`, `dependency`, `dropdown`, `email`, `file`, `formula`, `hour`, `link`, `location`, `long_text`, `numbers`, `people`, `phone`, `rating`, `status`, `tags`, `team`, `text`, `time_tracking`, `timeline`, `vote`, `week`, `world_clock`, and others.
columnTitle	`string`	Yes	The display title for the new column.
columnDescription	`string`	No	An optional description shown in the column header tooltip.
columnSettings	`string`	No	Column-specific configuration as a JSON string. Use `get_column_type_info` with `fetchMode: "schema"` to get the correct structure for a given type.

Example

Create a Status column on board 18412502536:

{
  "boardId": 18412502536,
  "columnType": "status",
  "columnTitle": "Status"
}

The tool returned the new column ID (color_mm37gbqg) and title (Status).

Programmatic equivalent

Use the GraphQL API to achieve the same result:

mutation {
  create_column(
    board_id: 18412502536
    title: "Status"
    column_type: status
  ) {
    id
    title
    type
  }
}

For full documentation, see Columns.