---
title: "Create an empty connected planning table"
method: POST
path: "/tables/from-connection"
tags: ["Planning Table"]
---

# Create an empty connected planning table

`POST /tables/from-connection`

Create a Planning Table from an eligible connection with mapped source columns, required system columns, and empty datasets for each selected scenario.

## Headers

- `X-Company-ID` string, required

## Request body

- PlanningTableCreateFromConnection — Mixin to delegate create, update, and destroy operations to a service class.
  - `name` string, required
  - `erp_connection_id` string, uuid, required
  - `sharing_scheme` 'ALL' | 'MANAGERS' | 'SPECIFIC' — * `ALL` - All Team Members * `MANAGERS` - Managers Only * `SPECIFIC` - Specific Users
  - `scenario_ids` integer[], required
  - `columns` ConnectedTableColumn[], required
    - `source_field` string, required
    - `name` string, required
    - `type` 'text' | 'number' | 'date', required — * `text` - text * `number` - number * `date` - date
    - `format` string, nullable

## 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)