---
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. Also the path param for team endpoints (e.g. /users/:id) and the parent_id reference on team members.
  - `first_name` string, required — Given name on the account.
  - `last_name` string, required — Family name on the account.
  - `seconds` integer, required — Remaining test seconds (credit balance) on the account; -1 means unlimited (e.g. Live plans).
  - `last_login` string, date-time, required — ISO-8601 timestamp of the most recent dashboard login.
  - `plan` string, required — Subscription plan name (e.g. "Free Trial", "Live - 5 Sessions - Unlimited", "Automated Pro ..."). For a sub-account this is the team owner's plan.
  - `max_concurrent` integer, required — Maximum number of parallel VM-based sessions allowed by the plan. For a sub-account this is the team owner's cap.
  - `max_concurrent_mobile` integer, required — Maximum number of parallel physical device sessions allowed by the plan. For a sub-account this is the team owner's cap.
  - `company` string, required — Optional company name for billing.
  - `street` string, required — Billing address line.
  - `city` string, required — Billing city.
  - `country` string, required — Billing country.
  - `vat` string, required — VAT number (EU only).
  - `read_only` boolean, required — Whether this account has read-only access within the team.
  - `roles` string[], required — Roles held by the account: "admin" and/or "owner".
  - `current_vm_concurrency` integer, required — VM-based sessions this account is running right now.
  - `current_physical_concurrency` integer, required — Physical-device sessions this account is running right now.

## 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/versions/eff607a49246/schema)