pve_user_create
Create a Proxmox VE user account. Runs as a dry-run by default to preview changes; set confirm=True to execute.
Instructions
MUTATION: create a user. Dry-run by default (note: password is set separately — the user cannot log in until then). confirm=True executes and returns a dict; synchronous, no UPID. Use pve_user_update to change it afterward, or pve_user_delete to remove it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Optional email address. | ||
| enable | No | Whether the account can log in; None defers to PVE's default (enabled). | |
| expire | No | Optional account expiry as a Unix timestamp; None means no expiry. | |
| groups | No | Comma-separated list of group ids to add the user to. | |
| userid | Yes | New user id, format 'user@realm'. | |
| comment | No | Optional free-text comment. | |
| confirm | No | False (default) returns a dry-run PLAN preview; True executes the mutation. | |
| lastname | No | Optional last name. | |
| firstname | No | Optional first name. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |