---
title: "POST /v1/lists/{id}/columns"
method: POST
path: "/v1/lists/{id}/columns"
---

# POST /v1/lists/{id}/columns

`POST /v1/lists/{id}/columns`

## Request

- Base URL: `https://api.servicegraph.co`
- URL: `https://api.servicegraph.co/v1/lists/{id}/columns`
- Auth: HTTP bearer

Add a user-defined typed column to a list. `key` is the stable identifier in items.values; `label` is the display name. select/multiselect columns require options.choices.

## Path parameters

- `id` string, required

## Request body

- object
  - `key` string, required
  - `label` string, required
  - `type` 'text' | 'longtext' | 'number' | 'date' | 'bool' | 'url' | 'select' | 'multiselect' | 'catalog', required
  - `options` object
  - `position` integer

## Response `200`

Default Response

---

[API](https://skmtc.dev/servicegraph/apis/servicegraph-api.md) · [All operations](https://skmtc.dev/servicegraph/apis/servicegraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/servicegraph/apis/servicegraph-api/revisions/f2f2f945c796?raw)