---
title: "Join Group"
method: POST
path: "/v2/groups/join"
tags: ["Groups"]
---

# Join Group

`POST /v2/groups/join`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/groups/join`
- Auth: HTTP bearer

Join a group using an invite link. Use this when you have received a group invite from an admin or member. Provide the invite link code. Network sharing is mutual: once joined you gain access to the shared network of all group members, and your own contacts become visible to every current and future member. Returns success confirmation. Fails if the invite is invalid or you are already a member.

## Request body

- JoinGroupRequest: Request body for joining a group via invite link
  - `group_invite_link` string, required

## Response `200`

Successfully joined group

- object
  - `data` JoinGroupResponse, required: Response after joining a group
    - `success` boolean, required
    - `message` string, required
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Group invite link not found or group not found
- `409`: User is already a member of this group
- `422`: Alumni communities not supported

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)