---
name: "fakturownia-users"
description: "Fakturownia CLI users: create or invite account users through the README-backed add-user endpoint and inspect the accepted user payload shape."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-departments"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "user create"
  cli_help: "fakturownia user --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema user create --json` before building invite or password-based user payloads, and pass `--integration-token` separately."
---

> Auto-generated by `go run ./cmd/gen-skills`. Do not edit manually.

# Users

> **PREREQUISITE:** Read [`fakturownia-shared`](../shared/SKILL.md) first.

## Use This Skill When

- The task is about adding or inviting a user to an account.
- You need the README-backed `user` payload shape, especially `invite`, `role`, and `department_ids[]`.

## Covered Commands

- `fakturownia user create` — Create or invite an account user

## Notable Flags

- `--input` (required): User JSON input as inline JSON, @file, or - for stdin
- `--integration-token` (required): Integration token required by the upstream add_user endpoint

## Environment

- `FAKTUROWNIA_PROFILE`: Select a profile unless --profile is provided
- `FAKTUROWNIA_URL`: Override the base account URL from any profile
- `FAKTUROWNIA_API_TOKEN`: Override the API token from any profile

## Request Discovery

- Use `fakturownia schema user create --json` before building invite or password-based user payloads.
- The CLI accepts the inner `user` object and wraps it into the upstream `{ "user": ... }` envelope.
- Pass `--integration-token` separately; the active profile supplies `api_token` automatically.
- Inspect request fields such as `invite`, `email`, `password`, `role`, and `department_ids[]` before constructing the payload.

## Examples

```bash
fakturownia user create --integration-token PARTNER_TOKEN --input '{"invite":true,"email":"user@example.com","role":"member"}' --json
fakturownia user create --integration-token PARTNER_TOKEN --input '{"invite":false,"email":"user@example.com","password":"secret","role":"admin","department_ids":[1,2]}' --json
fakturownia user create --integration-token PARTNER_TOKEN --input @user.json --dry-run --json
```

## Related Skills

- [fakturownia-shared](../shared/SKILL.md)
- [fakturownia-departments](../departments/SKILL.md)
- [fakturownia-schema](../schema/SKILL.md)
- [fakturownia-doctor](../doctor/SKILL.md)