---
title: "Create Team User"
method: POST
path: "/v2/teams/{team_id}/users"
tags: ["Team User API"]
---

# Create Team User

`POST /v2/teams/{team_id}/users`

Add a user to a team with a specified role.

## Path parameters

- `team_id` string, required

## Request body

- object
  - `userId` string, required
  - `role` 'TEAM_USER_ROLE_UNSPECIFIED' | 'TEAM_USER_ROLE_AGENT' | 'TEAM_USER_ROLE_MANAGER' | 'TEAM_USER_ROLE_BUILDER' | 'TEAM_USER_ROLE_VIEWER' | 'TEAM_USER_ROLE_CONTRIBUTOR' | 'TEAM_USER_ROLE_DRAFTER' | 'TEAM_USER_ROLE_READONLY_AGENT' | 'TEAM_USER_ROLE_APP_BUILDER', required

## Response `200`

Success

- SvauthPublicCreateTeamUserResponse
  - `data` SvauthPublicTeamUser
    - `teamId` string
    - `userId` string
    - `role` 'TEAM_USER_ROLE_UNSPECIFIED' | 'TEAM_USER_ROLE_AGENT' | 'TEAM_USER_ROLE_MANAGER' | 'TEAM_USER_ROLE_BUILDER' | 'TEAM_USER_ROLE_VIEWER' | 'TEAM_USER_ROLE_CONTRIBUTOR' | 'TEAM_USER_ROLE_DRAFTER' | 'TEAM_USER_ROLE_READONLY_AGENT' | 'TEAM_USER_ROLE_APP_BUILDER'
    - `createdAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `id` string — Composite identifier in the format {team_id}:{user_id}.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)