---
title: "Add a column"
method: POST
path: "/modules/{moduleId}/columns"
tags: ["Structure"]
---

# Add a column

`POST /modules/{moduleId}/columns`

## Request

- Base URL: `https://api.teamo360.com/api/v1`
- URL: `https://api.teamo360.com/api/v1/modules/{moduleId}/columns`
- Auth: HTTP bearer

Rides the versioned delta column-ops engine; response includes createdColumnId. Computed columns MUST carry a config, because the values cannot be inferred and an unconfigured computed column would stay blank forever; a missing key answers 400. rollup needs source_scope ("activities" or "activity_details") and target_field_id (a column id from the activity group), optionally source_group_id to scope it to one group and aggregation (sum, avg, median, min, max, count, concatenate, unique; defaults to sum). lookup needs source_linked_column_id (a linked_record column on this same module) and display_field_map keyed by TARGET MODULE ID to the column id being read, plus an optional aggregation. formula needs expression, referencing other columns as {column-id}. linked_record takes target: { moduleId, level: "record" } (or level "activity" with activityGroupId); a column links to ONE module, so target_module_ids with several modules answers 400 linked_record_multiple_targets (one id is still accepted and stored as target; reads return target_module_ids for a record target, read-only). Get the ids from GET /modules/{moduleId}/columns and GET /modules/{moduleId}/activity-groups.

Requires the `schema:write` token scope.

Admin-role principals only.

## Path parameters

- `moduleId` string, required

## Request body

- object

## Response `200`

Success

## Other responses

- `400`: Malformed parameters or body
- `401`: Missing, invalid, expired, or legacy token
- `403`: Blocked by role, token scope, module grant, or org policy
- `404`: Entity missing or outside the principal’s access
- `429`: Rate limit exceeded - see Retry-After

---

[API](https://skmtc.dev/teamo360/apis/teamo-public-api.md) · [All operations](https://skmtc.dev/teamo360/apis/teamo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/teamo360/apis/teamo-public-api/revisions/32528ecbc4f4?raw)