---
title: "ezgh hosted-queues users create"
description: "Create a user."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh hosted-queues users create

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh hosted-queues users create <cluster> <name> [--preset p | --vhost name=preset | --permissions json] [--wait] [flags]
```

Create a user. Its password is generated and written to a new Secret in the project, which `users get` names; ezgh never prints it. Without permissions a Kafka user is readWrite. Kafka users take `--preset`: admin (every topic and group; create, delete and configure topics), readWrite (produce and consume every topic, every group, create topics) or readOnly (consume). RabbitMQ users take `--vhost` name=readWrite or name=readOnly, once per vhost. Custom grants go in `--permissions`, the API's JSON: Kafka &#123;"preset":"custom","topics":\[&#123;"topic":"orders.\*","access":"produceConsume","create":true&#125;\], "groups":\[&#123;"group":"workers-\*"&#125;\]&#125;; RabbitMQ &#123;"vhosts":\[&#123;"vhost":"app","preset":"custom","configure":"^$","write":"^jobs","read":".\*"&#125;\]&#125;.

Part of [`ezgh hosted-queues users`](/cli/reference/hosted-queues-users).

## Examples

```sh
ezgh hosted-queues users create events snuba --preset admin --wait
ezgh hosted-queues users create jobs worker --vhost /=readWrite --wait
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--permissions` | string |  | the permissions as the API's JSON, for custom grants (see `--help`) |
| `--preset` | string |  | Kafka: admin, readWrite or readOnly |
| `--vhost` | string, repeatable |  | RabbitMQ: a vhost and its preset, name=readWrite or name=readOnly (/ is the default vhost); repeat for more |
| `--wait` | boolean |  | wait until it's available, and print it then |
| `--wait-timeout` | duration | `10m0s` | how long `--wait` waits |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/hosted-queues-users-create/index.mdx
