---
title: "Create a user in your team"
method: POST
path: "/v1/team-management/users"
tags: ["Team"]
---

# Create a user in your team

`POST /v1/team-management/users`

Provisions a new sub-account inside the team, copying the caller's subscription level and assigning a slice of the credit pool. Requires an upgraded plan and admin role.

## Request body

- PostV1TeamManagementUsers — Create a user in your team
  - `email` string, required — Email address for the new account; must be unique across TestingBot.
  - `password` string, required — Initial password for the new user.
  - `first_name` string — New user's given name.
  - `last_name` string — New user's family name.
  - `concurrency` integer — Max parallel VM sessions (≤ team owner's `maxParallel`).
  - `concurrencyPhysical` integer — Max parallel physical-device sessions (≤ team owner's `maxParallelDevice`).

## Response `201`

Create a user in your team

- TestingbotEntitiesTeamMember — Testingbot_Entities_TeamMember model
  - `id` integer, required — Unique numeric user ID.
  - `first_name` string, required — Given name.
  - `last_name` string, required — Family name.
  - `email` string, required — Account email.
  - `credits` integer, required — Remaining VM credit seconds.
  - `device_credits` integer, required — Remaining physical-device credit seconds.
  - `isPaid` boolean, required — Whether the account has an active paid plan.
  - `verified` boolean, required — Whether the account email has been verified.
  - `parent_id` integer, required — Parent (team owner) user ID; 0 means this user is the team owner.

## Other responses

- `401` — Authentication required
- `403` — Caller is not on a paid plan / not admin

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/revisions/8f493cca8f92/schema)