Skip to main content
Create a group dimension — a grouping axis your company’s groups hang off. A dimension holds no members itself: create the axis here, then call create_group once per value it takes (‘Country’ → ‘France’, ‘Spain’). The new dimension is added as a picklist field to every reporting table, so it can be used as a report breakdown straight away. 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 grouping axis, as people will read it in Qobra — ‘Country’, ‘Segment’, ‘Squad’.
​
string
required
The dimension’s stable key: the identifier an integration matches it on, distinct from the display name. Lowercase and underscore-separated by convention (e.g. ‘sales_region’).
​
string
Optional free-text note about what the axis groups.

​
Response

Body

​
object
The dimension as it now exists — the same shape list_group_dimensions returns, so the id can be reused straight away.