brivio-cli

Brivio CLI (brivio-cli)

Command-line access to the Brivio public API — manage contacts, invoices, projects, contracts, documents, articles, API keys and webhooks from your terminal or CI scripts.

Install

npm install -g brivio-cli

Authenticate

brivio login          # prompts for your API key (brivio_sk_live_… / brivio_sk_test_…)
brivio me             # show current organization info
brivio logout

The key is stored in your user config directory. You can also pass --api-key / BRIVIO_API_KEY per invocation.

Commands

Every resource follows the same list | get | create | update | delete shape:

brivio contacts list --page 2
brivio contacts create --name "ACME SRL" --vat-number RO12345678
brivio invoices list --status ISSUED
brivio projects get <id>
brivio contracts list
brivio documents list
brivio articles list

API keys

brivio api-keys list
brivio api-keys create --name "CI key" --scopes contacts:read,invoices:read
brivio api-keys revoke <id>

Webhooks

brivio webhooks list
brivio webhooks create --url https://app.example/hooks \
  --events invoice.paid,contact.created --description "Prod hooks"
brivio webhooks update <id> --events invoice.paid --deactivate
brivio webhooks rotate-secret <id>      # prints the new signing secret ONCE
brivio webhooks deliveries <id> --status failed
brivio webhooks delete <id>

Inventory & HR

brivio inventory stock --below-min          # low-stock report
brivio inventory movements --type SALE
brivio inventory nir list --status CONFIRMED
brivio inventory nir get <id>
brivio hr employees --department "Vanzari" --status ACTIVE

Webhook payloads are signed with HMAC-SHA256 — see the webhook docs for the X-Brivio-Signature verification scheme (or use verifyWebhookSignature from @brivio/sdk).

Output

All commands support --json for machine-readable output; the default is a human-friendly table.

License

MIT