---
title: "Create Abacus Account"
method: POST
path: "/companies/{company_id}/abacus-accounts"
tags: ["companies"]
---

# Create Abacus Account

`POST /companies/{company_id}/abacus-accounts`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/abacus-accounts`
- Auth: none declared

Add an Abacus account to a company (accountant/owner). Service password encrypted at
rest, never returned. For a company user (not a platform admin) ``base_url`` must be https on a
public address (422 ``invalid.integrationHost``).

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- AbacusAccountCreate: ``POST /companies/<id>/abacus-accounts`` body (admin). ``service_password`` is the dedicated AbaConnect service-user password; it is encrypted at rest and never returned. The encrypted column is Text, so the raw secret has no tight upper bound here.
  - `label` string, required
  - `base_url` string, required
  - `mandant` string, required
  - `interface_version` string
  - `service_user` string, required
  - `service_password` string, required
  - `fetch_journal` boolean
  - `fetch_invoices` boolean
  - `fetch_documents` boolean
  - `poll_batch_cap` integer, nullable
  - `feeds_config` object, nullable
  - `enabled` boolean
  - `allow_private_host` boolean, nullable

## Response `201`

Successful Response

- AbacusAccountResponse: ``GET/POST/PATCH /abacus-accounts/...`` → ``{"abacus_account": ...}``.
  - `abacus_account` AbacusAccountOut, required: Serialized abacus account (no secret); includes feed toggles + per-feed state.
    - `id` string, required
    - `company_id` string, required
    - `label` string, required
    - `enabled` boolean, required
    - `base_url` string, required
    - `mandant` string, required
    - `interface_version` string, required
    - `service_user` string, required
    - `fetch_journal` boolean, required
    - `fetch_invoices` boolean, required
    - `fetch_documents` boolean, required
    - `poll_batch_cap` integer, nullable
    - `feeds_config` object, nullable
    - `sync_state` object, nullable
    - `allow_private_host` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)