---
title: "Creates a new user in the given group"
method: POST
path: "/group/user"
tags: ["group"]
---

# Creates a new user in the given group

`POST /group/user`

Creates new users within a specified organizational group. Provisions user accounts with credentials, roles, and group membership in a single operation.

## Request body

- UserDataPost[]
  - `group_id` integer — The group ID to which the user should belong to
  - `group_ext_id` string — An external identifier set for group
  - `first_name` string, required — The users first name
  - `last_name` string, required — The users last name
  - `user_email` string, required — The users e-mail address / login
  - `user_ext_id` string — The users external id
  - `ring_to` integer — The full ring-to number
  - `agent_id` integer — An external identifier set for user
  - `role` 'Admin' | 'Standard' | 'Read-Only' | 'Identified-only', required — The user account type set for user
  - `user_status` 'active' | 'inactive'
  - `aliases` string — Optional comma separated list of user alias
  - `timezone` 'America/Halifax' | 'America/New_York' | 'America/Chicago' | 'America/Denver' | 'America/Phoenix' | 'America/Los_Angeles' | 'utc', required — The users timezone

## Response `200`

Newly created user IDs with confirmation status for each user

- StandardPostResponse[]
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `data` string, required — Response payload. Shape varies by endpoint.
  - `entry_count` integer, required — The sequential number of the entry in the submitted array. Type: integer (int32).

## Other responses

- `default` — Unexpected error

---

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