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.0
- license
- MIT
- versions
- 2
- 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.
https://hub.omadia.aisetup 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
- Go to developer.bexio.com/pat and sign in with your Bexio account.
- 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
| Field | Value |
|---|---|
| API Token | The 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-Resetheader. - Cannot reach the host —
api.bexio.commust be in the network allow-list (it is, by default).
versions
setup fields
Values the operator fills in at install-time.
permissions
memory
reads: [0] · writes: [0]
graph
reads: [0] · writes: [0]
network
outbound: [1]
filesystem
scratch: false