omadiaomadia.ai
registry
integrationbexio

Bexio (Swiss SME software)

@omadia/integration-bexio

Bexio connector for omadia. PAT-authenticated read-only REST client. Publishes the 'bexio.client' + 'bexio.cache' services and contributes read tools for contacts, invoices, quotes (Offerten), orders, items and projects.

latest
v0.2.1
license
MIT
versions
3
author
byte5 GmbH

install

In your omadia instance, open Admin → Registries and add this registry, then install Bexio (Swiss SME software) from Admin → Plugins → Store.

registryhttps://hub.omadia.ai

setup guide

Connect Bexio

This integration talks to the Bexio API using a Personal Access Token (PAT) as a bearer token — no interactive sign-in.

1. Create a Personal Access Token

  1. Go to developer.bexio.com/pat and sign in with your Bexio account.
  2. Create a new token, give it a name (e.g. "omadia"), and copy the token value immediately (it is shown only once).

A PAT has your account's full default scopes and is valid for 6 months. Note the expiry and re-issue before it lapses. Revoke a token any time on the same page.

2. Fill in the field below

FieldValue
API TokenThe PAT value from step 1

Install — the connection is verified in the background with a GET /3.0/permissions call (watch the plugin logs for connected or a permissions probe failed warning).

Troubleshooting

  • 401 / 403 — the PAT is wrong, expired, or revoked. Re-issue at developer.bexio.com/pat.
  • 429 — Bexio rate limit (per minute). Retry after the time in the RateLimit-Reset header.
  • Cannot reach the host — api.bexio.com must be in the network allow-list (it is, by default).

versions

v0.2.1
>=1.0 <2.013.9 KB2026-08-18
.zipefbb303de2f3…
v0.2.0
>=1.0 <2.013.3 KB2026-07-02
.zipa8a1f604ef0b…
v0.1.0
>=1.0 <2.013.2 KB2026-07-02
.zip458d7c5e5935…

setup fields

Values the operator fills in at install-time.

bexio_api_tokensecret
API TokenBexio Personal Access Token from developer.bexio.com/pat. Stored encrypted in the vault. Maps to BEXIO_API_TOKEN.
required
bexio_base_urlstring
API Base URLBexio API base. Default https://api.bexio.com — only change for a proxy/sandbox.
optional
bexio_max_bytesstring
Max response size (bytes)Caps a single Bexio response to prevent memory blow-ups. Default 1048576 (1 MiB).
optional
bexio_cache_ttl_secondsstring
Read cache TTL (seconds)How long identical reads are cached in-process. Default 60.
optional

permissions

memory

reads: [0] · writes: [0]

graph

reads: [0] · writes: [0]

network

outbound: [1]

filesystem

scratch: false