Skip to main content
Create a local data table — the structure records are then imported into. A data table is the root most of a compensation plan hangs off: fields, record reports, scopes and quotas all point at one. This creates the empty structure with its name field; add its other columns with create_data_table_field, and load its rows by Excel import from the Qobra web app. The table matches each record’s owner on the user’s email address. Tables synced from an integration are created from that integration’s settings instead, not here. Available only where the Qobra write tools beta is enabled. Every write is recorded in the audit trail as the Qobra MCP agent.

​
Parameters

Body

​
string
required
Display name of the table, as people will read it in Qobra — ‘Deals’, ‘Subscriptions’, ‘Invoices’.
​
string
The table’s stable key: the identifier the public API addresses it by, distinct from the display name. Lowercase and underscore-separated, and unique across the company. Omit to derive it from the name (‘Closed Deals’ gives ‘closed_deals’).
​
string
Label of the column holding each record’s unique identifier in the source data. Defaults to ‘Record ID’.
​
string
Label of the column holding each record’s name — what a record is listed as throughout Qobra. Defaults to ‘Name’.

​
Response

Body

​
object
The data table as it now exists — the same row list_data_tables returns, so the id can be reused straight away.