---
title: "Create a planning table"
method: POST
path: "/tables"
tags: ["Planning Table"]
---

# Create a planning table

`POST /tables`

Planning tables store a typed column schema (number, text, dimension, and calculated columns).

A calculated column's output type is inferred from its formula on save and controls whether numeric formatting applies; formulas with an ambiguous type or invalid dimension usage are rejected.

## Headers

- `X-Company-ID` string, required

## Request body

- PlanningTable — Mixin to delegate create, update, and destroy operations to a service class.
  - `id` integer, required
  - `company_id` string, uuid, required
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `name` string, required
  - `sharing_scheme` 'ALL' | 'MANAGERS' | 'SPECIFIC' — * `ALL` - All Team Members * `MANAGERS` - Managers Only * `SPECIFIC` - Specific Users
  - `schema` unknown, required
  - `schema_reviewed` boolean
  - `erp_connection_id` string, uuid, nullable, required
  - `created_by_id` integer, required
  - `modified_by_id` integer, required
  - `has_templates` boolean, required
  - `shared_with` string[]

## Response `201`

- PlanningTable — Mixin to delegate create, update, and destroy operations to a service class.
  - `id` integer, required
  - `company_id` string, uuid, required
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `name` string, required
  - `sharing_scheme` 'ALL' | 'MANAGERS' | 'SPECIFIC' — * `ALL` - All Team Members * `MANAGERS` - Managers Only * `SPECIFIC` - Specific Users
  - `schema` unknown, required
  - `schema_reviewed` boolean
  - `erp_connection_id` string, uuid, nullable, required
  - `created_by_id` integer, required
  - `modified_by_id` integer, required
  - `has_templates` boolean, required
  - `shared_with` string[]

---

[API](https://skmtc.net/cubesoftware/apis/cube-api.md) · [All operations](https://skmtc.net/cubesoftware/apis/cube-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cubesoftware/cube-api/revisions/67d9f45bb99b/schema)