skills/goodmem-sdk/references/python/users/create.md

<!-- sdk-ref package=goodmem registry=pypi version=0.1.34 -->

# users.create

Create a human user

Creates one dormant human user after requiring instance-wide CREATE_USER authority. Creation does not issue a credential or create a role, grant, or authentication mapping.

Args:
    user_id (str, optional): Optional client-provided user UUID; generated by the server when omitted.
    email (str): Unique, nonempty email address.
    username (str, optional): Optional unique username.
    display_name (str, optional): Optional human-facing display name.
    labels (dict[str, str], optional): Optional labels for organization and filtering. At most 20 entries; keys and values contain at most 255 characters; keys use [a-z0-9._-].

Returns:
    UserResponse

```python
users.create(*, email: 'str', user_id: 'str | None' = None, username: 'str | None' = None, display_name: 'str | None' = None, labels: 'dict[str, str] | None' = None) -> 'UserResponse'
```

[users](../users.md) · [Python](../../python.md)