> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qobra.co/llms.txt
> Use this file to discover all available pages before exploring further.

# create_group_dimension

> Create a group dimension — the grouping axis your company's groups hang off — added straight away as a picklist field on every reporting table.

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`](/mcp_documentation/tools/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

<Accordion title="Body" defaultOpen>
  <ParamField body="name" type="string" required>
    Display name of the grouping axis, as people will read it in Qobra —
    'Country', 'Segment', 'Squad'.
  </ParamField>

  <ParamField body="key" type="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').
  </ParamField>

  <ParamField body="description" type="string">
    Optional free-text note about what the axis groups.
  </ParamField>
</Accordion>

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="dimension" type="object">
    The dimension as it now exists — the same shape list\_group\_dimensions
    returns, so the id can be reused straight away.

    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="name" type="string" />

      <ResponseField name="key" type="string">
        The dimension's stable key — the identifier used to match it when synced
        from an integration, distinct from its display name.
      </ResponseField>

      <ResponseField name="archived" type="boolean" />

      <ResponseField name="group_count" type="integer">
        Number of groups that belong to this dimension. Zero for a
        just-created dimension.
      </ResponseField>
    </Expandable>
  </ResponseField>
</Accordion>