---
title: "Join Team"
method: POST
path: "/v2/teams/join"
tags: ["Teams"]
---

# Join Team

`POST /v2/teams/join`

## Request

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

Join a team using an invite link. Use this when you have received a team invite link from an admin. Provide the invite link code (the part after /join/ in the URL). Network sharing is mutual: you gain access to teammates’ networks, and your own contacts become visible to every current and future member of the team. Returns status "joined", or "pending" when the team (Business or Enterprise) needs an admin to approve new members. Fails if the invite link is invalid or you are already a team member.

## Request body

- JoinTeamRequest: Request body for joining a team via invite link
  - `team_invite_link` string, required

## Response `200`

Successfully joined team

- object
  - `data` JoinTeamResponse, required: Response after joining a team
    - `success` boolean, required
    - `message` string, required
    - `status` 'joined' | 'pending': "pending": a Business or Enterprise team needs an admin to approve the request
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Team invite link not found
- `409`: Conflict - user already in team

---

[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)