---
title: "POST /networks/{networkId}/users"
method: POST
path: "/networks/{networkId}/users"
---

# POST /networks/{networkId}/users

`POST /networks/{networkId}/users`

Creates multiple users in a specified Wickr network. This operation allows you to provision multiple user accounts simultaneously, optionally specifying security groups, and validation requirements for each user.

`codeValidation`, `inviteCode`, and `inviteCodeTtl` are restricted to networks under preview only.

## Path parameters

- `networkId` string, required

## Headers

- `X-Client-Token` string

## Request body

- object
  - `users` BatchCreateUserRequestItem[], required — A list of user objects containing the details for each user to be created, including username, name, security groups, and optional invite codes. Maximum 50 users per batch request.
    - `firstName` string, password — The first name of the user.
    - `lastName` string, password — The last name of the user.
    - `securityGroupIds` SecurityGroupId[], required — A list of security group IDs to which the user should be assigned.
    - `username` string, required — The email address or username for the user. Must be unique within the network.
    - `inviteCode` string — A custom invite code for the user. If not provided, one will be generated automatically.
    - `inviteCodeTtl` integer — The time-to-live for the invite code in days. After this period, the invite code will expire.
    - `codeValidation` boolean — Indicates whether the user can be verified through a custom invite code.

## Response `200`

Success

- BatchCreateUserResponse
  - `message` string — A message indicating the overall result of the batch operation.
  - `successful` User[] — A list of user objects that were successfully created, including their assigned user IDs and invite codes.
    - `userId` string — The unique identifier for the user within the network.
    - `firstName` string, password — The first name of the user.
    - `lastName` string, password — The last name of the user.
    - `username` string — The email address or username of the user. For bots, this must end in 'bot'.
    - `securityGroups` SecurityGroupId[] — A list of security group IDs to which the user is assigned, determining their permissions and feature access.
    - `isAdmin` boolean — Indicates whether the user has administrator privileges in the network.
    - `suspended` boolean — Indicates whether the user is currently suspended and unable to access the network.
    - `status` integer — The current status of the user (1 for pending invitation, 2 for active).
    - `otpEnabled` boolean — Indicates whether one-time password (OTP) authentication is enabled for the user.
    - `scimId` string — The SCIM (System for Cross-domain Identity Management) identifier for the user, used for identity synchronization. Currently not used.
    - `type` string — The descriptive type of the user account (e.g., 'user').
    - `cell` string — The phone number minus country code, used for cloud deployments.
    - `countryCode` string — The country code for the user's phone number, used for cloud deployments.
    - `challengeFailures` integer — The number of failed password attempts for enterprise deployments, used for account lockout policies.
    - `isInviteExpired` boolean — Indicates whether the user's email invitation code has expired, applicable to cloud deployments.
    - `isUser` boolean — Indicates whether this account is a user (as opposed to a bot or other account type).
    - `inviteCode` string — The invitation code for this user, used during registration to join the network.
    - `codeValidation` boolean — Indicates whether the user can be verified through a custom invite code.
    - `uname` string — The unique identifier for the user.
  - `failed` BatchUserErrorResponseItem[] — A list of user creation attempts that failed, including error details explaining why each user could not be created.
    - `field` string — The field that caused the error.
    - `reason` string — A description of why the user operation failed.
    - `userId` string, required — The user ID associated with the failed operation.

## Other responses

- `480` — ValidationError
- `481` — BadRequestError
- `482` — ResourceNotFoundError
- `483` — ForbiddenError
- `484` — UnauthorizedError
- `485` — InternalServerError
- `486` — RateLimitError

---

[API](https://skmtc.net/aws/apis/wickr.md) · [All operations](https://skmtc.net/aws/apis/wickr/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/wickr/revisions/71d396c2af63/schema)