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

> Create a group — one value of an existing dimension — added straight away to the dimension's picklist in every reporting table.

Create a group — one value of an existing dimension ('EMEA' under 'Region').

The dimension has to exist first; create it with
[`create_group_dimension`](/mcp_documentation/tools/create_group_dimension).
The group is created empty: this tool attributes no users to it. The new value
is added to the dimension's picklist in every reporting table, so reports can
break down by it 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="dimension_id" type="string" required>
    Id of the dimension the group belongs to — the id list\_group\_dimensions
    returns, or the one create\_group\_dimension just returned. Never a
    dimension name.
  </ParamField>

  <ParamField body="name" type="string" required>
    Display name of the group, one value of its dimension — 'France' under a
    'Country' dimension.
  </ParamField>

  <ParamField body="key" type="string" required>
    The group's stable key: the identifier an integration matches it on,
    distinct from the display name. Lowercase and underscore-separated by
    convention (e.g. 'emea\_north').
  </ParamField>
</Accordion>

## Response

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

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

      <ResponseField name="resource_url" type="string">
        Deep link to open this group in the Qobra web app.
      </ResponseField>

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

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

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

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

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

      <ResponseField name="member_count" type="integer">
        Number of users currently in the group. Zero for a just-created group.
      </ResponseField>
    </Expandable>
  </ResponseField>
</Accordion>