> For the complete documentation index, see [llms.txt](https://docs.tnid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tnid.com/api-reference/001_user/007_groups/018__create_group_user_member_join_request.md).

# Create A Group Join Request

GraphQL endpoint: `/user`

Requests to join a group. The request is sent to the group admins for approval. Once approved, the user becomes a member of the group.

## Query

```graphql
mutation (
  $groupId: ID!
) {
  createGroupUserMemberJoinRequest (
    groupId: $groupId
  ) {
    id
    status
    role
    insertedAt
    respondedAt
    updatedAt
    group {
      id
    }
    user {
      id
    }
  }
}

```

## Variables

```json
{
  "groupId": "00000000-0000-4000-8000-000000000001"
}
```

## Response

```json
{
  "data": {
    "createGroupUserMemberJoinRequest": {
      "group": {
        "id": "00000000-0000-4000-8000-000000000001"
      },
      "id": "00000000-0000-4000-8000-000000000002",
      "insertedAt": "2026-01-15T09:00:00",
      "respondedAt": null,
      "role": "MEMBER",
      "status": "PENDING",
      "updatedAt": "2026-01-15T09:00:00",
      "user": {
        "id": "00000000-0000-4000-8000-000000000003"
      }
    }
  }
}
```