---
title: "Create a custom column on a list"
method: POST
path: "/business/lists/{listId}/columns"
tags: ["Custom columns"]
---

# Create a custom column on a list

`POST /business/lists/{listId}/columns`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/lists/{listId}/columns`
- Auth: HTTP basic

Adds a plain custom column to the list. `type` fixes what cells may hold — `string` (default), `number`, `date`, `boolean`, or `url` (a `{label, value}` link). Names are unique per list, case-insensitively (409 COLUMN_NAME_TAKEN). Write cells with `PATCH .../columns/{columnId}/values`; for an AI-computed column use `POST .../smart-columns` instead.

Errors:
- `404` `LIST_NOT_FOUND` — No list with that id is visible to the token owner.
- `409` `COLUMN_NAME_TAKEN` — A column with this name (case-insensitive) already exists on the list.
- `422` `VALIDATION_FAILED` — name missing/blank/over 100 characters, type outside the enum, or an unknown key.
- `429` `RATE_LIMITED` — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.

## Path parameters

- `listId` string, required: 24-character hex id of the list (from GET /business/lists).

## Request body

- object
  - `name` string, required: Column name (1-100 characters); unique per list (case-insensitive) or the call answers 409 COLUMN_NAME_TAKEN.
  - `type` 'string' | 'number' | 'date' | 'boolean' | 'url': Value type the column stores: string (default), number, date, boolean or url (a {label, value} link).

## Response `201`

Success

- object
  - `column` object, required
    - `id` string, required
    - `name` string, required
    - `type` 'string' | 'number' | 'date' | 'boolean' | 'url', required

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)