---
name: "fakturownia-webhooks"
description: "Fakturownia CLI webhooks: list, fetch, create, update, and delete webhooks using conservative README-backed request and output discovery."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-clients"
    - "fakturownia-invoices"
    - "fakturownia-products"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "webhook list"
    - "webhook get"
    - "webhook create"
    - "webhook update"
    - "webhook delete"
  cli_help: "fakturownia webhook --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema webhook list --json` for output fields and `fakturownia schema webhook create --json` before building full top-level webhook request objects."
---

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

# Webhooks

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

## Use This Skill When

- The task is about reading or mutating webhooks.
- You need the conservative webhook `kind`, `url`, `api_token`, and `active` request contract without inventing undocumented wrapper keys.

## Covered Commands

- `fakturownia webhook list` — List webhooks
- `fakturownia webhook get` — Fetch a single webhook by ID
- `fakturownia webhook create` — Create a webhook from the full top-level request object
- `fakturownia webhook update` — Update a webhook from the full top-level request object
- `fakturownia webhook delete` — Delete a webhook

## Notable Flags

- `--page` (default `1`): Requested result page
- `--per-page` (default `25`): Requested result count per page
- `--id` (required): Webhook ID
- `--input` (required): Full webhook request JSON as inline JSON, @file, or - for stdin
- `--yes` (required, default `false`): Confirm webhook deletion

## 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

## Output and Request Discovery

- Use `fakturownia schema webhook list --json` and `fakturownia schema webhook get --json` before building selectors.
- Read `output.known_fields` to discover conservative webhook fields such as `kind`, `url`, `api_token`, `active`, `created_at`, and `updated_at`.
- Use `fakturownia schema webhook create --json` and `fakturownia schema webhook update --json` to inspect `request_body_schema` before building webhook payloads.
- Unlike most CRUD nouns, webhook create and update accept the full top-level request object because the direct README documents endpoints but not a wrapper key.
- Start from the curated `kind` values in schema output and keep the payload conservative rather than inventing undocumented fields.

## Examples

```bash
fakturownia webhook list --json
fakturownia webhook list --columns id,kind,url,active
fakturownia webhook list --page 2 --per-page 25 --raw
fakturownia webhook get --id 7
fakturownia webhook get --id 7 --fields id,kind,url,active --json
fakturownia webhook get --id 7 --raw
fakturownia webhook create --input '{"kind":"invoice:create","url":"https://example.com/hook","api_token":"secret","active":true}' --json
fakturownia webhook create --input @webhook.json
fakturownia webhook create --input '{"kind":"invoice:create","url":"https://example.com/hook"}' --dry-run --json
fakturownia webhook update --id 7 --input '{"active":false}' --json
fakturownia webhook update --id 7 --input @webhook-update.json
fakturownia webhook update --id 7 --input '{"url":"https://example.com/hook"}' --dry-run --json
fakturownia webhook delete --id 7 --yes --json
fakturownia webhook delete --id 7 --yes --dry-run --json
```

## Related Skills

- [fakturownia-shared](../shared/SKILL.md)
- [fakturownia-clients](../clients/SKILL.md)
- [fakturownia-invoices](../invoices/SKILL.md)
- [fakturownia-products](../products/SKILL.md)
- [fakturownia-schema](../schema/SKILL.md)
- [fakturownia-doctor](../doctor/SKILL.md)