# Create a direct group membership

Launch stage: Beta

`POST /api/2.0/identity/groups/{group_id}/direct-members`

Creates a group membership (assigns a principal to a group).

API scopes: identity

## Path parameters

- `group_id` (int64, required)
  Required. Internal ID of the group in Databricks.

## Request body

Required. The group membership to create.
- `principal_id` (int64, required, Immutable)
  Internal ID of the principal in Databricks.

## Returns

Returns the DirectGroupMember object.

## Response

```json
{
  "principal_id": 0,
  "principal_type": "USER",
  "membership_source": "INTERNAL",
  "display_name": "string",
  "external_id": "string",
  "group_id": 0
}
```