Skip to main content
Create an empty local data table, with its name field only. A data table is the root most of a compensation plan hangs off: fields, record reports, scopes and quotas all point at one. Add its other columns with create_data_table_field and its rows with create_record; bulk loading is an Excel import in the Qobra web app. The table matches each record’s owner on the user’s email. A table synced from an integration is created from the integration’s settings, not here. 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 (‘Deals’, ‘Invoices’).
string
The table’s key in the public API. Lowercase letters, digits and _ only, stored as sent, 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 name field, the one column the table is created with. 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.