> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to bexio

The bexio connector lets your AI agent act in each user's bexio account. Each user connects their own bexio access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** Bearer Token
**Categories:** Accounting & Finance, CRM & Sales
**Tools:** 60: 33 read, 23 write, 4 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=BEXIO)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the bexio connection

   In **AgentKit > Connections**, create a bexio connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'bexio'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize bexio:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'bexio_accounts_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "bexio"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize bexio:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="bexio_accounts_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their bexio credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'bexio_accounts_list',
  toolInput: {},
  connector: 'bexio',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="bexio_accounts_list",
    tool_input={},
    connection_name="bexio",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `bexio_accounts_list`

List Accounts · Read-only

List the chart of accounts.
Returns an array of objects with id, uuid, account_no, name, account_type, tax_id, fibu_account_group_id, is_active.
Use bexio_accounts_list to find an account ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{}`

### `bexio_bill_get`

Get Supplier Bill · Read-only

Get one supplier bill.
Returns an object with id, document_no, title, status, firstname_suffix, lastname_company, created_at, supplier_id, vendor_ref, pending_amount, and more.
Use bexio_bill_get for one bill.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `bill_id` (`string`, required): Bill ID (UUID). Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

Example input: `{"bill_id":"<bill_id>"}`

### `bexio_bills_list`

List Supplier Bills · Read-only

List supplier bills (purchase invoices), filtered by status or date.
Returns data[] (each with id, document_no, title, status, firstname_suffix, lastname_company, vendor, created_at) plus paging.
Use bexio_bills_list to review payables. Use bexio_bill_get for one bill.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `average_exchange_rate_enabled` (`boolean`, optional): Indicates whether 'average_exchange_rate_enabled' is enabled, or not. Example: False
- `bill_date_end` (`string`, optional): Filter for Bill 'bill_date', the latest accepted date. Example: 2019-04-27
- `bill_date_start` (`string`, optional): Filter for Bill 'bill_date', the earliest accepted date. Example: 2019-04-19
- `currency_code` (`string`, optional): Filter for Bill 'currency_code', text containing in field. Example: CHF
- `document_no` (`string`, optional): Filter for Bill 'document_no', text containing in field. Example: DC-123
- `due_date_end` (`string`, optional): Filter for Bill 'due_date', the latest accepted date. Example: 2019-05-27
- `due_date_start` (`string`, optional): Filter for Bill 'due_date', the earliest accepted date. Example: 2019-05-19
- `gross_max` (`number`, optional): Filter for Bill 'gross', the greatest accepted value. Example: 465.75
- `gross_min` (`number`, optional): Filter for Bill 'gross', the lowest accepted value. Example: 438.32
- `limit` (`integer`, optional): Maximum number of results (up to 500). Example: 100
- `net_max` (`number`, optional): Filter for Bill 'net', the greatest accepted value. Example: 465.75
- `net_min` (`number`, optional): Filter for Bill 'net', the lowest accepted value. Example: 438.32
- `order` (`string`, optional): Sorting order. Example: ['asc', 'desc']
- `page` (`integer`, optional): Page number. Example: 1
- `pending_amount_max` (`number`, optional): Filter for Bill 'pending_amount', the greatest accepted value. Example: 465.75
- `pending_amount_min` (`number`, optional): Filter for Bill 'pending_amount', the lowest accepted value. Example: 438.32
- `search_term` (`string`, optional): Term for which application will look for (minimum 3 signs, maximum 255 signs) Example: term
- `sort` (`string`, optional): Field to sort by. Example: document_no
- `status` (`string`, optional): Filter for Bill 'status' (DRAFTS: [DRAFT], TODO: [BOOKED, PARTIALLY_CREATED, CREATED, PARTIALLY_SENT, SENT, PARTIALLY_DOWNLOADED, DOWNLOADED, PARTIALLY_PAID, PARTIALLY_FAILED, FAILED], PAID: [PAID], OVERDUE: [BOOKED, PARTIALLY_CREATED, CREATED, PARTIALLY_SENT, SENT, PARTIALLY_DOWNLOADED, DOWNLOADED, PARTIALLY_PAID, PARTIALLY_FAILED, FAILED]) and for 'onlyOverdue' (DRAFTS: [FALSE], TODOS: [FALSE], PAID: [FALSE], OVERD... One of: DRAFTS, TODO, PAID, OVERDUE. Example: TODO. One of: `DRAFTS`, `TODO`, `PAID`, `OVERDUE`.
- `supplier_id` (`integer`, optional): Filter for Bill 'supplier_id'. Example: 1234
- `title` (`string`, optional): Filter for Bill 'title', text containing in field. Example: Some Title
- `vendor` (`string`, optional): Filter for Bill 'vendor', text containing in fields lastname_company and firstname_suffix. Example: bexio ag
- `vendor_ref` (`string`, optional): Filter for Bill 'vendor_ref', text containing in field. Example: reference

Example input: `{}`

### `bexio_company_profile_list`

Get Company Profile · Read-only

Get the company profile (name, address, VAT number, bank details).
Returns an array of objects with id, name, address, address_nr, postcode, city, country_id, legal_form.
Use bexio_company_profile_list for the company details of the account.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `bexio_contact_get`

Get Contact · Read-only

Get one contact with address, email, phone and groups.
Returns an object with id, nr, contact_type_id, name_1, name_2, salutation_id, salutation_form, title_id, titel_id, birthday, and more.
Use bexio_contact_get for one contact.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Contact ID, from bexio_contacts_list or bexio_contacts_search. Example: 4
- `show_archived` (`boolean`, optional): Show archived elements only. Example: True

Example input: `{"contact_id":4}`

### `bexio_contact_groups_list`

List Contact Groups · Read-only

List contact groups.
Returns an array of objects with id, name.
Use bexio_contact_groups_list to find contact_group_ids.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, name. Example: id_desc. One of: `id`, `name`.

Example input: `{}`

### `bexio_contact_relations_list`

List Contact Relations · Read-only

List relations between contacts (for example a person working at a company).
Returns an array of objects with id, contact_id, contact_sub_id, description, updated_at.
Use bexio_contact_relations_list to see who belongs to which company.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, contact_id, contact_sub_id, updated_at. Example: id_desc. One of: `id`, `contact_id`, `contact_sub_id`, `updated_at`.

Example input: `{}`

### `bexio_contacts_list`

List Contacts · Read-only

List contacts (companies and people).
Returns an array of objects with id, nr, contact_type_id, name_1, name_2, salutation_id, salutation_form, title_id.
Use bexio_contacts_list to browse. Use bexio_contacts_search to find contacts by name, email or other fields.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, nr, name_1, updated_at. Example: id_desc. One of: `id`, `nr`, `name_1`, `updated_at`.
- `show_archived` (`boolean`, optional): If true, list archived contacts only. Example: false

Example input: `{}`

### `bexio_contacts_search`

Search Contacts · Read-only

Search contacts by fields such as name_1, name_2, nr, mail, city, postcode or contact_group_ids.
Returns an array of objects with id, nr, contact_type_id, name_1, name_2, salutation_id, salutation_form, title_id.
Use bexio_contacts_search to find a contact ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `criteria` (`array`, required): Search criteria; each item has a field, a value and an optional criteria operator (=, !=, >, <, >=, <=, like, not_like, is_null, not_null, in, not_in). Criteria are combined with AND. Example: [{"field": "name_1", "value": "Muster", "criteria": "like"}]
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, nr, name_1, updated_at. Example: id_desc. One of: `id`, `nr`, `name_1`, `updated_at`.
- `show_archived` (`boolean`, optional): If true, search archived contacts only. Example: false

Example input: `{"criteria":[{"field":"name_1","value":"Muster","criteria":"like"}]}`

### `bexio_currencies_list`

List Currencies · Read-only

List the currencies set up in the company.
Returns an array of objects with id, name, round_factor, exchange_rate, exchange_rate_id, ratio, exchange_rate_to_ratio, source.
Use bexio_currencies_list to find a currency_id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date` (`string`, optional): The validity date for the fetched exchange rate. Example: 2019-05-17
- `embed` (`string`, optional): The embed parameters is being used for embedding related resources in the response. Example In case of embed=exchange_rate the fields exchange_rate, exchange_rate_id, ratio, exchange_rate_to_ratio, source, source_reason and exchange_rate_date are shown.
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{}`

### `bexio_expenses_list`

List Expenses · Read-only

List expenses.
Returns data[] (each with id, document_no, title, status, firstname_suffix, lastname_company, vendor, created_at) plus paging.
Use bexio_expenses_list to review spending.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_end` (`string`, optional): Filter for Expense 'created_at', the latest accepted date. Example: 2020-01-27T13:08:01+0000
- `created_at_start` (`string`, optional): Filter for Expense 'created_at', the earliest accepted date. Example: 2020-01-24T13:08:01+0000
- `currency_code` (`string`, optional): Filter for Expense 'currency_code', text containing in field. Example: CHF
- `document_no` (`string`, optional): Filter for Expense 'document_no', text containing in field. Example: DC-123
- `gross_max` (`number`, optional): Filter for Expense 'gross', the greatest accepted value. Example: 465.75
- `gross_min` (`number`, optional): Filter for Expense 'gross', the lowest accepted value. Example: 438.32
- `limit` (`integer`, optional): Maximum number of results (up to 500). Example: 100
- `net_max` (`number`, optional): Filter for Expense 'net', the greatest accepted value. Example: 465.75
- `net_min` (`number`, optional): Filter for Expense 'net', the lowest accepted value. Example: 438.32
- `order` (`string`, optional): Sorting order. Example: ['asc', 'desc']
- `page` (`integer`, optional): Page number. Example: 1
- `paid_on_end` (`string`, optional): Filter for Expense 'paid_on', the latest accepted date. Example: 2019-04-27
- `paid_on_start` (`string`, optional): Filter for Expense 'paid_on', the earliest accepted date. Example: 2019-04-19
- `project_id` (`string`, optional): Filter for Expense 'project_id'. Example: 1a1864c0-ba80-46a8-ad89-ffd128db9456
- `sort` (`string`, optional): Field to sort by. Example: document_no
- `supplier_id` (`integer`, optional): Filter for Expense 'supplier_id'. Example: 1234
- `title` (`string`, optional): Filter for Expense 'title', text containing in field. Example: Some Title
- `vendor` (`string`, optional): Filter for Expense 'vendor', text containing in fields lastname_company and firstname_suffix. Example: bexio ag

Example input: `{}`

### `bexio_invoice_get`

Get Invoice · Read-only

Get one invoice with positions, totals, taxes and status.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_invoice_get for one invoice.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID, from bexio_invoices_list. Example: 12

Example input: `{"invoice_id":12}`

### `bexio_invoice_payments_list`

List Invoice Payments · Read-only

List the payments recorded on an invoice.
Returns an array of objects with id, date, value, bank_account_id, title, payment_service_id, is_client_account_redemption, is_cash_discount.
Use bexio_invoice_payments_list to see what was paid.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID, from bexio_invoices_list. Example: 12
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{"invoice_id":12}`

### `bexio_invoices_list`

List Invoices · Read-only

List customer invoices.
Returns an array of objects with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id.
Use bexio_invoices_list to browse. Use bexio_invoices_search to filter by contact, status or date.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, total, total_net, total_gross, updated_at. Example: id_desc. One of: `id`, `total`, `total_net`, `total_gross`, `updated_at`.

Example input: `{}`

### `bexio_invoices_search`

Search Invoices · Read-only

Search invoices by fields such as contact_id, kb_item_status_id, document_nr, title or is_valid_from.
Returns an array of objects with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id.
Use bexio_invoices_search to find open or overdue invoices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `criteria` (`array`, required): Search criteria; each item has a field, a value and an optional criteria operator. Example: [{"field": "kb_item_status_id", "value": "8", "criteria": "="}]
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, total, total_net, total_gross, updated_at. Example: id_desc. One of: `id`, `total`, `total_net`, `total_gross`, `updated_at`.

Example input: `{"criteria":[{"field":"kb_item_status_id","value":"8","criteria":"="}]}`

### `bexio_item_get`

Get Item · Read-only

Get one item with prices, taxes and stock.
Returns an object with id, user_id, article_type_id, contact_id, deliverer_code, deliverer_name, deliverer_description, intern_code, intern_name, intern_description, and more.
Use bexio_item_get for one item.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `article_id` (`integer`, required): Item ID. Example: 3

Example input: `{"article_id":3}`

### `bexio_items_list`

List Items · Read-only

List items (products and services).
Returns an array of objects with id, user_id, article_type_id, contact_id, deliverer_code, deliverer_name, deliverer_description, intern_code.
Use bexio_items_list to browse. Use bexio_items_search to find items by code or name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, intern_name. Example: id_desc. One of: `id`, `intern_name`.

Example input: `{}`

### `bexio_items_search`

Search Items · Read-only

Search items by fields such as intern_name, intern_code or contact_id.
Returns an array of objects with id, user_id, article_type_id, contact_id, deliverer_code, deliverer_name, deliverer_description, intern_code.
Use bexio_items_search to find an article_id for a document position.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `criteria` (`array`, required): Search criteria; each item has a field, a value and an optional criteria operator. Example: [{"field": "intern_name", "value": "Consulting", "criteria": "like"}]
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, intern_name. Example: id_desc. One of: `id`, `intern_name`.

Example input: `{"criteria":[{"field":"intern_name","value":"Consulting","criteria":"like"}]}`

### `bexio_notes_list`

List Notes · Read-only

List notes.
Returns an array of objects with id, user_id, event_start, subject, info, contact_id, project_id, pr_project_id.
Use bexio_notes_list to read notes on contacts and projects.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{}`

### `bexio_order_get`

Get Order · Read-only

Get one order with positions, totals and status.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_order_get for one order.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Order ID. Example: 5

Example input: `{"order_id":5}`

### `bexio_orders_list`

List Orders · Read-only

List sales orders.
Returns an array of objects with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id.
Use bexio_orders_list to browse. Use bexio_orders_search to filter.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, total, total_net, total_gross, updated_at. Example: id_desc. One of: `id`, `total`, `total_net`, `total_gross`, `updated_at`.

Example input: `{}`

### `bexio_orders_search`

Search Orders · Read-only

Search orders by fields such as contact_id, kb_item_status_id, document_nr or title.
Returns an array of objects with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id.
Use bexio_orders_search to find an order ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `criteria` (`array`, required): Search criteria; each item has a field, a value and an optional criteria operator. Example: [{"field": "contact_id", "value": "4"}]
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, total, total_net, total_gross, updated_at. Example: id_desc. One of: `id`, `total`, `total_net`, `total_gross`, `updated_at`.

Example input: `{"criteria":[{"field":"contact_id","value":"4"}]}`

### `bexio_project_get`

Get Project · Read-only

Get one project.
Returns an object with id, uuid, nr, document_nr, name, start_date, end_date, comment, pr_state_id, pr_project_type_id, and more.
Use bexio_project_get for one project.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID. Example: 2

Example input: `{"project_id":2}`

### `bexio_projects_list`

List Projects · Read-only

List projects.
Returns an array of objects with id, uuid, nr, document_nr, name, start_date, end_date, comment.
Use bexio_projects_list to browse. Use bexio_projects_search to filter.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, name. Example: id_desc. One of: `id`, `name`.

Example input: `{}`

### `bexio_projects_search`

Search Projects · Read-only

Search projects by fields such as name, contact_id or pr_state_id.
Returns an array of objects with id, uuid, nr, document_nr, name, start_date, end_date, comment.
Use bexio_projects_search to find a project ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `criteria` (`array`, required): Search criteria; each item has a field, a value and an optional criteria operator. Example: [{"field": "name", "value": "Website", "criteria": "like"}]
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, name. Example: id_desc. One of: `id`, `name`.

Example input: `{"criteria":[{"field":"name","value":"Website","criteria":"like"}]}`

### `bexio_quote_get`

Get Quote · Read-only

Get one quote with positions, totals and status.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_quote_get for one quote.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `quote_id` (`integer`, required): Quote ID, from bexio_quotes_list. Example: 7

Example input: `{"quote_id":7}`

### `bexio_quotes_list`

List Quotes · Read-only

List quotes (offers).
Returns an array of objects with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id.
Use bexio_quotes_list to browse. Use bexio_quotes_search to filter.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, total, total_net, total_gross, updated_at. Example: id_desc. One of: `id`, `total`, `total_net`, `total_gross`, `updated_at`.

Example input: `{}`

### `bexio_quotes_search`

Search Quotes · Read-only

Search quotes by fields such as contact_id, kb_item_status_id, document_nr or title.
Returns an array of objects with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id.
Use bexio_quotes_search to find a quote ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `criteria` (`array`, required): Search criteria; each item has a field, a value and an optional criteria operator. Example: [{"field": "contact_id", "value": "4"}]
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, total, total_net, total_gross, updated_at. Example: id_desc. One of: `id`, `total`, `total_net`, `total_gross`, `updated_at`.

Example input: `{"criteria":[{"field":"contact_id","value":"4"}]}`

### `bexio_tasks_list`

List Tasks · Read-only

List tasks.
Returns an array of objects with id, user_id, finish_date, subject, place, info, contact_id, sub_contact_id.
Use bexio_tasks_list to see open to-dos.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, finish_date. Example: id_desc. One of: `id`, `finish_date`.

Example input: `{}`

### `bexio_taxes_list`

List Taxes · Read-only

List VAT rates with their IDs.
Returns an array of objects with id, uuid, name, code, digit, type, account_id, tax_settlement_type.
Use bexio_taxes_list to find tax_id values for document positions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date` (`string`, optional): Displays all taxes which are active at the date given. Example: 2018-03-17
- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `scope` (`string`, optional): Can be used to filter for active or inactive taxes. One of: active, inactive. Example: active. One of: `active`, `inactive`.
- `types` (`string`, optional): Filter the types of the tax. One of: sales_tax, pre_tax. Example: sales_tax. One of: `sales_tax`, `pre_tax`.

Example input: `{}`

### `bexio_timesheets_list`

List Timesheets · Read-only

List time entries.
Returns an array of objects with id, user_id, status_id, client_service_id, text, allowable_bill, charge, contact_id.
Use bexio_timesheets_list to review tracked time.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0
- `order_by` (`string`, optional): Sort field, optionally with _asc or _desc; combine several with commas. One of: id, date. Example: id_desc. One of: `id`, `date`.

Example input: `{}`

### `bexio_user_me_get`

Get Current User · Read-only

Get the bexio user the token belongs to.
Returns an object with id, salutation_type, firstname, lastname, email, is_superadmin, is_accountant.
Use bexio_user_me_get to check the connection and find your user_id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `bexio_users_list`

List Users · Read-only

List the users of the bexio company.
Returns an array of objects with id, salutation_type, firstname, lastname, email, is_superadmin, is_accountant.
Use bexio_users_list to find a user_id for documents, tasks and timesheets.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results (up to 2000, default 500). Example: 100
- `offset` (`integer`, optional): Number of results to skip. Example: 0

Example input: `{}`

### `bexio_contact_create`

Create Contact · Write

Create a contact: a company (contact_type_id 1) or a person (contact_type_id 2).
Returns an object with id, nr, contact_type_id, name_1, name_2, salutation_id, salutation_form, title_id, titel_id, birthday, and more.
Use bexio_contact_create for a new customer or supplier.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `contact_type_id` (`integer`, required): Contact type: 1 company, 2 person. Example: 1
- `name_1` (`string`, required): Company name, or last name for a person. Example: Muster AG
- `owner_id` (`integer`, required): User who owns the contact. Example: 1
- `user_id` (`integer`, required): User responsible for the contact. Example: 1
- `address_addition` (`string`, optional): Requires street_name if the value is not NULL. Example: Building C
- `birthday` (`string`, optional): Birthday of a person contact, YYYY-MM-DD. Example: 1985-04-12
- `city` (`string`, optional): City. Example: Zürich
- `contact_branch_ids` (`string`, optional): References one ore multiple contact sector objects. Example: abc123
- `contact_group_ids` (`string`, optional): Contact group IDs, comma-separated. Example: 1,2
- `country_id` (`integer`, optional): Country ID. Example: 1
- `house_number` (`string`, optional): Requires street_name if the value is not NULL. Example: 77
- `language_id` (`integer`, optional): References a language object. Example: 12345
- `mail` (`string`, optional): Main email address. Example: info@muster.ch
- `name_2` (`string`, optional): Company addition, or first name for a person. Example: Hans
- `nr` (`string`, optional): If set to null, the number will be assigned automatically. Must be a number, can also be used as integer. Example: example
- `phone_fixed` (`string`, optional): Landline phone number. Example: +41 44 123 45 67
- `phone_mobile` (`string`, optional): Mobile phone number. Example: +41 79 123 45 67
- `postcode` (`string`, optional): Postal code. Example: 8000
- `remarks` (`string`, optional): Free-text remarks. Example: Prefers email
- `salutation_id` (`integer`, optional): References a salutation object. Example: 2
- `street_name` (`string`, optional): Is required if house_number or address_addition are not NULL. Example: Smith Street
- `title_id` (`integer`, optional): References a title object. Example: 12345
- `url` (`string`, optional): Website. Example: https://www.muster.ch

Example input: `{"contact_type_id":1,"name_1":"<name_1>","owner_id":1,"user_id":1}`

### `bexio_contact_update`

Update Contact · Write

Update a contact; only the fields you send change.
Returns an object with id, nr, contact_type_id, name_1, name_2, salutation_id, salutation_form, title_id, titel_id, birthday, and more.
Use bexio_contact_update to edit a contact.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Contact ID, from bexio_contacts_list or bexio_contacts_search. Example: 4
- `address_addition` (`string`, optional): Requires street_name if the value is not NULL. Example: Building C
- `birthday` (`string`, optional): Birthday of a person contact, YYYY-MM-DD. Example: 1985-04-12
- `city` (`string`, optional): City. Example: Zürich
- `contact_branch_ids` (`string`, optional): References one ore multiple contact sector objects. Example: abc123
- `contact_group_ids` (`string`, optional): References one ore multiple contact group objects. Example: 1,2
- `contact_type_id` (`integer`, optional): Contact type: 1 company, 2 person. Example: 1
- `country_id` (`integer`, optional): References a country object. Example: 1
- `house_number` (`string`, optional): Requires street_name if the value is not NULL. Example: 77
- `language_id` (`integer`, optional): References a language object. Example: 12345
- `mail` (`string`, optional): Main email address. Example: info@muster.ch
- `name_1` (`string`, optional): Company name, or last name for a person. Example: Muster AG
- `name_2` (`string`, optional): Company addition, or first name. Example: Hans
- `nr` (`string`, optional): If set to null, the number will be assigned automatically. Must be a number, can also be used as integer. Example: example
- `owner_id` (`integer`, optional): User who owns the contact. Example: 1
- `phone_fixed` (`string`, optional): Landline phone number. Example: +41 44 123 45 67
- `phone_mobile` (`string`, optional): Mobile phone number. Example: +41 79 123 45 67
- `postcode` (`string`, optional): Postal code. Example: 8000
- `remarks` (`string`, optional): Free-text remarks. Example: Prefers email
- `salutation_id` (`integer`, optional): References a salutation object. Example: 2
- `street_name` (`string`, optional): Is required if house_number or address_addition are not NULL. Example: Smith Street
- `title_id` (`integer`, optional): References a title object. Example: 12345
- `url` (`string`, optional): Website. Example: https://www.muster.ch
- `user_id` (`integer`, optional): References a user object. Example: 1

Example input: `{"contact_id":4}`

### `bexio_invoice_create`

Create Invoice · Write

Create a draft invoice for a contact with line items.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_invoice_create for a new invoice, then bexio_invoice_issue and bexio_invoice_send.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `contact_id` (`integer`, required): Customer contact ID. Example: 4
- `user_id` (`integer`, required): ID of the bexio user responsible for the document, from bexio_users_list. Example: 1
- `api_reference` (`string`, optional): This field can only be read and edited by the api. It can be used to save references to other systems. Example: example
- `bank_account_id` (`integer`, optional): References a bank account object. Example: 1
- `contact_address_manual` (`string`, optional): This field can be used to set a contact address manually. If not in use or null the invoice address of the contact will be taken. Example: UTA Immobilien AG
Stadtturmstrasse 15
5400 Baden
- `contact_sub_id` (`integer`, optional): References a contact object. Example: 12345
- `currency_id` (`integer`, optional): References a currency object. Example: 1
- `document_nr` (`string`, optional): Can not be used if “automatic numbering” is activated in frontend-settings. Required if “automatic numbering” deactivated. https://help.bexio.com/s/article/000001784. Example: RE-00001
- `footer` (`string`, optional): Text below the positions on the document. Example: Payable within 30 days.
- `header` (`string`, optional): Text above the positions on the document. Example: Thank you for your order.
- `is_valid_from` (`string`, optional): Document date, YYYY-MM-DD. Example: 2026-11-16
- `is_valid_to` (`string`, optional): Due date, YYYY-MM-DD. Example: 2026-12-16
- `language_id` (`integer`, optional): References a language object. Example: 1
- `mwst_is_net` (`boolean`, optional): This value affects the total if the field mwst_type has been set to 0. false = Taxes are included in the total true = Taxes will be added to the total. Example: True
- `mwst_type` (`integer`, optional): VAT handling: 0 including taxes, 1 excluding taxes, 2 exempt. One of: 0, 1, 2. Example: 0. One of: `0`, `1`, `2`.
- `payment_type_id` (`integer`, optional): References a payment type object. Example: 1
- `positions` (`array`, optional): Line items. A custom position is {"type": "KbPositionCustom", "amount": "1", "unit_price": "1200.00", "tax_id": 16, "text": "Design work"}; an item position uses "type": "KbPositionArticle" with article_id. Example: [{"type": "KbPositionCustom", "amount": "1", "unit_price": "1200.00", "tax_id": 16, "text": "Design work"}]
- `pr_project_id` (`integer`, optional): References a project object. Example: 12345
- `reference` (`string`, optional): Your reference shown on the invoice. Example: PO-4711
- `show_position_taxes` (`boolean`, optional): If true, show the tax of each position on the document. Example: false
- `template_slug` (`string`, optional): References a document template slug. Example: 581a8010821e01426b8b456b
- `title` (`string`, optional): Document title. Example: Website redesign

Example input: `{"contact_id":4,"user_id":1}`

### `bexio_invoice_issue`

Issue Invoice · Write

Issue a draft invoice so it becomes open and gets its number.
Returns an object with success.
Use bexio_invoice_issue before sending.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID, from bexio_invoices_list. Example: 12

Example input: `{"invoice_id":12}`

### `bexio_invoice_payment_create`

Record Invoice Payment · Write

Record a payment against an issued invoice.
Returns an object with id, date, value, bank_account_id, title, payment_service_id, is_client_account_redemption, is_cash_discount, kb_invoice_id, kb_credit_voucher_id, and more.
Use bexio_invoice_payment_create when a customer has paid.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID, from bexio_invoices_list. Example: 12
- `value` (`string`, required): Amount paid as a decimal string. Example: 1200.00
- `bank_account_id` (`integer`, optional): Bank account that received the money. Example: 1
- `date` (`string`, optional): Payment date, YYYY-MM-DD. Example: 2026-11-16
- `payment_service_id` (`integer`, optional): | value | description | |-----|------| | 1 | PayPal | | 2 | Stripe | | 3 | SIX Payments |. One of: 0, 1, 2. Example: 0. One of: `0`, `1`, `2`.

Example input: `{"invoice_id":12,"value":"<value>"}`

### `bexio_invoice_send`

Send Invoice · Write

Email an issued invoice to the customer.
Returns an object with success.
Use bexio_invoice_send to deliver an invoice. This emails the recipient.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID, from bexio_invoices_list. Example: 12
- `message` (`string`, required): Email text; it must contain the placeholder [Network Link]. Example: Dear customer, please find your invoice here: [Network Link]
- `recipient_email` (`string`, required): Recipient email address. Example: billing@muster.ch
- `subject` (`string`, required): Email subject. Example: Invoice RE-00012
- `attach_pdf` (`boolean`, optional): Attach PDF directly to the email. Example: True
- `mark_as_open` (`boolean`, optional): If true, mark the document as open (issued) when sending. Example: true

Example input: `{"invoice_id":12,"message":"<message>","recipient_email":"<recipient_email>","subject":"<subject>"}`

### `bexio_invoice_update`

Update Invoice · Write

Update a draft invoice.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_invoice_update to change a draft before issuing it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID, from bexio_invoices_list. Example: 12
- `api_reference` (`string`, optional): This field can only be read and edited by the api. It can be used to save references to other systems. Example: example
- `bank_account_id` (`integer`, optional): References a bank account object. Example: 1
- `contact_address_manual` (`string`, optional): This field can be used to set a contact address manually. If not in use or null the invoice address of the contact will be taken. Example: UTA Immobilien AG
Stadtturmstrasse 15
5400 Baden
- `contact_id` (`integer`, optional): Customer contact ID. Example: 4
- `contact_sub_id` (`integer`, optional): References a contact object. Example: 12345
- `currency_id` (`integer`, optional): References a currency object. Example: 1
- `document_nr` (`string`, optional): Can not be used if “automatic numbering” is activated in frontend-settings. Required if “automatic numbering” deactivated. https://help.bexio.com/s/article/000001784. Example: RE-00001
- `footer` (`string`, optional): Text below the positions on the document. Example: Payable within 30 days.
- `header` (`string`, optional): Text above the positions on the document. Example: Thank you for your order.
- `is_valid_from` (`string`, optional): Document date, YYYY-MM-DD. Example: 2026-11-16
- `is_valid_to` (`string`, optional): Due date, YYYY-MM-DD. Example: 2026-12-16
- `language_id` (`integer`, optional): References a language object. Example: 1
- `mwst_is_net` (`boolean`, optional): This value affects the total if the field mwst_type has been set to 0. false = Taxes are included in the total true = Taxes will be added to the total. Example: True
- `mwst_type` (`integer`, optional): VAT handling: 0 including taxes, 1 excluding taxes, 2 exempt. One of: 0, 1, 2. Example: 0. One of: `0`, `1`, `2`.
- `payment_type_id` (`integer`, optional): References a payment type object. Example: 1
- `pr_project_id` (`integer`, optional): References a project object. Example: 12345
- `reference` (`string`, optional): Your reference shown on the invoice. Example: PO-4711
- `show_position_taxes` (`boolean`, optional): If true, show the tax of each position on the document. Example: false
- `template_slug` (`string`, optional): References a document template slug. Example: 581a8010821e01426b8b456b
- `title` (`string`, optional): Document title. Example: Website redesign
- `user_id` (`integer`, optional): ID of the bexio user responsible for the document, from bexio_users_list. Example: 1

Example input: `{"invoice_id":12}`

### `bexio_item_create`

Create Item · Write

Create an item (product or service).
Returns an object with id, user_id, article_type_id, contact_id, deliverer_code, deliverer_name, deliverer_description, intern_code, intern_name, intern_description, and more.
Use bexio_item_create to add something you sell.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `intern_name` (`string`, required): Item name. Example: Consulting hour
- `user_id` (`integer`, required): User ID. Example: 1
- `account_id` (`integer`, optional): References an account object. Example: 12345
- `article_type_id` (`integer`, optional): Item type: 1 physical product, 2 service. Example: 2
- `contact_id` (`integer`, optional): References a contact object. Example: 14
- `currency_id` (`integer`, optional): References a currency object. Example: 12345
- `expense_account_id` (`integer`, optional): References an account object. Example: 12345
- `intern_code` (`string`, optional): Item code. Example: CONS-1
- `intern_description` (`string`, optional): Item description shown on documents. Example: One hour of consulting
- `is_stock` (`boolean`, optional): Requires stock_edit scope to work. Example: False
- `purchase_price` (`string`, optional): Purchase price as a decimal string. Example: 80.00
- `remarks` (`string`, optional): Free-text remarks. Example: Prefers email
- `sale_price` (`string`, optional): Sale price as a decimal string. Example: 150.00
- `stock_id` (`integer`, optional): References a stock location object. Example: 12345
- `stock_nr` (`integer`, optional): Please note that the stock number can only be set if no bookings for this product have been made. Example: 0
- `stock_place_id` (`integer`, optional): References a stock area object. Example: 12345
- `tax_expense_id` (`integer`, optional): References a tax object. Example: 12345
- `tax_income_id` (`integer`, optional): References a tax object. Example: 12345
- `unit_id` (`integer`, optional): References a unit object. Example: 12345

Example input: `{"intern_name":"<intern_name>","user_id":1}`

### `bexio_item_update`

Update Item · Write

Update an item; only the fields you send change.
Returns an object with id, user_id, article_type_id, contact_id, deliverer_code, deliverer_name, deliverer_description, intern_code, intern_name, intern_description, and more.
Use bexio_item_update to change an item price or name.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `article_id` (`integer`, required): Item ID. Example: 3
- `account_id` (`integer`, optional): References an account object. Example: 12345
- `contact_id` (`integer`, optional): References a contact object. Example: 14
- `currency_id` (`integer`, optional): References a currency object. Example: 12345
- `expense_account_id` (`integer`, optional): References an account object. Example: 12345
- `intern_code` (`string`, optional): Item code. Example: CONS-1
- `intern_description` (`string`, optional): Item description shown on documents. Example: One hour of consulting
- `intern_name` (`string`, optional): Item name. Example: Consulting hour
- `is_stock` (`boolean`, optional): Requires stock_edit scope to work. Example: False
- `purchase_price` (`string`, optional): Purchase price as a decimal string. Example: 80.00
- `remarks` (`string`, optional): Free-text remarks. Example: Prefers email
- `sale_price` (`string`, optional): Sale price as a decimal string. Example: 160.00
- `stock_id` (`integer`, optional): References a stock location object. Example: 12345
- `stock_nr` (`integer`, optional): Please note that the stock number can only be set if no bookings for this product have been made. Example: 0
- `stock_place_id` (`integer`, optional): References a stock area object. Example: 12345
- `tax_expense_id` (`integer`, optional): References a tax object. Example: 12345
- `tax_income_id` (`integer`, optional): References a tax object. Example: 12345
- `unit_id` (`integer`, optional): References a unit object. Example: 12345
- `user_id` (`integer`, optional): References a user object (Currently, it has no impact, regardless of which user_id is sent.) Example: 1

Example input: `{"article_id":3}`

### `bexio_note_create`

Create Note · Write

Create a note, optionally linked to a contact or project.
Returns an object with id, user_id, event_start, subject, info, contact_id, project_id, pr_project_id, entry_id, module_id.
Use bexio_note_create to log a call or meeting.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `event_start` (`string`, required): Date and time of the event. Example: 2026-11-16 14:00:00
- `subject` (`string`, required): Note subject. Example: Call with Muster AG
- `user_id` (`integer`, required): Author user ID. Example: 1
- `contact_id` (`integer`, optional): References a contact object. Example: 14
- `info` (`string`, optional): Note text. Example: Agreed on a renewal in December.
- `pr_project_id` (`integer`, optional): References a project object. Example: 12345

Example input: `{"event_start":"<event_start>","subject":"<subject>","user_id":1}`

### `bexio_order_create`

Create Order · Write

Create a sales order for a contact with line items.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_order_create for a confirmed sale.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `contact_id` (`integer`, required): Customer contact ID. Example: 4
- `user_id` (`integer`, required): ID of the bexio user responsible for the document, from bexio_users_list. Example: 1
- `api_reference` (`string`, optional): This field can only be read and edited by the api. It can be used to save references to other systems. Example: example
- `bank_account_id` (`integer`, optional): References a bank account object. Example: 1
- `contact_address_manual` (`string`, optional): This field can be used to set a contact address manually. If not in use or null the invoice address of the contact will be taken. Example: UTA Immobilien AG
Stadtturmstrasse 15
5400 Baden
- `contact_sub_id` (`integer`, optional): References a contact object. Example: 12345
- `currency_id` (`integer`, optional): References a currency object. Example: 1
- `delivery_address_manual` (`string`, optional): This field can be used to set a delivery address manually if delivery_address_type is set to 1. If not in use or null the invoice address will be taken. Example: UTA Immobilien AG
Stadtturmstrasse 15
5400 Baden
- `delivery_address_type` (`integer`, optional): | value | description | |-------|-------------| | 0 | use invoice address | | 1 | use custom address |. One of: 0, 1. Example: 0. One of: `0`, `1`.
- `document_nr` (`string`, optional): Can not be used if “automatic numbering” is activated in frontend-settings. Required if “automatic numbering” deactivated. https://help.bexio.com/s/article/000001784. Example: AU-00001
- `footer` (`string`, optional): Text below the positions on the document. Example: Payable within 30 days.
- `header` (`string`, optional): Text above the positions on the document. Example: Thank you for your order.
- `is_valid_from` (`string`, optional): Document date, YYYY-MM-DD. Example: 2026-11-16
- `language_id` (`integer`, optional): References a language object. Example: 1
- `mwst_is_net` (`boolean`, optional): This value affects the total if the field mwst_type has been set to 0. false = Taxes are included in the total true = Taxes will be added to the total. Example: True
- `mwst_type` (`integer`, optional): VAT handling: 0 including taxes, 1 excluding taxes, 2 exempt. One of: 0, 1, 2. Example: 0. One of: `0`, `1`, `2`.
- `payment_type_id` (`integer`, optional): References a payment type object. Example: 1
- `positions` (`array`, optional): Line items. A custom position is {"type": "KbPositionCustom", "amount": "1", "unit_price": "1200.00", "tax_id": 16, "text": "Design work"}; an item position uses "type": "KbPositionArticle" with article_id. Example: [{"type": "KbPositionCustom", "amount": "1", "unit_price": "1200.00", "tax_id": 16, "text": "Design work"}]
- `pr_project_id` (`integer`, optional): References a project object. Example: 12345
- `show_position_taxes` (`boolean`, optional): If true, show the tax of each position on the document. Example: false
- `template_slug` (`string`, optional): References a document template slug. Example: 581a8010821e01426b8b456b
- `title` (`string`, optional): Document title. Example: Website redesign

Example input: `{"contact_id":4,"user_id":1}`

### `bexio_order_invoice_create`

Create Invoice from Order · Write

Create an invoice from an order.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_order_invoice_create to bill an order.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): Order ID. Example: 5
- `positions` (`array`, optional): Please note that the positions array can be omitted to create a document with all positions from the source document. Example: [{"key": "value"}]

Example input: `{"order_id":5}`

### `bexio_project_archive`

Archive Project · Write

Archive a project.
Returns an object with success.
Use bexio_project_archive when a project is finished.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`integer`, required): Project ID. Example: 2

Example input: `{"project_id":2}`

### `bexio_project_create`

Create Project · Write

Create a project for a contact.
Returns an object with id, uuid, nr, document_nr, name, start_date, end_date, comment, pr_state_id, pr_project_type_id, and more.
Use bexio_project_create to start tracking work for a customer.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `contact_id` (`integer`, required): Customer contact ID. Example: 4
- `name` (`string`, required): Project name. Example: Website relaunch
- `pr_project_type_id` (`integer`, required): Project type ID: 1 internal, 2 customer project. Example: 2
- `pr_state_id` (`integer`, required): Project status ID: 1 active, 2 open, 3 archived. Example: 2
- `user_id` (`integer`, required): Responsible user ID. Example: 1
- `comment` (`string`, optional): Project comment. Example: Fixed price project
- `contact_sub_id` (`integer`, optional): References a contact object. Example: 12345
- `document_nr` (`string`, optional): Can not be used if “automatic numbering” is activated in frontend-settings. Required if “automatic numbering” deactivated. https://help.bexio.com/s/article/000001721. Example: project name
- `end_date` (`string`, optional): Project end, YYYY-MM-DD HH:MM:SS. Example: 2027-03-31 00:00:00
- `pr_budget_type_amount` (`string`, optional): This field can only be edited if the pr_budget_type is set. (Only supported for budget types: type_budgeted_costs and type_budgeted_hours) Example: 200.00
- `pr_budget_type_id` (`number`, optional): The following budget types are available: | Id | Name | Description | | ------ | ------ | ------ | | 1 | type_budgeted_costs | Total budget costs | | 2 | type_budgeted_hours | Total budget hours | | 3 | type_service_budget | Budget for each client services | | 4 | type_service_employees | Budget for each employee |. Example: 1
- `pr_invoice_type_amount` (`string`, optional): This field can only be edited if the pr_invoice_type is set. (Only supported for invoice types: type_hourly_rate_project and type_fix) Example: 230.00
- `pr_invoice_type_id` (`integer`, optional): The following invoice types are available: | Id | Name | Description | | ------ | ------ | ------ | | 1 | type_hourly_rate_service | Hourly rate for client services | | 2 | type_hourly_rate_employee | Hourly rate for employee | | 3 | type_hourly_rate_project | Hourly rate for project | | 4 | type_fix | Fix price for project |. Example: 3
- `start_date` (`string`, optional): Project start, YYYY-MM-DD HH:MM:SS. Example: 2026-11-16 00:00:00

Example input: `{"contact_id":4,"name":"<name>","pr_project_type_id":2,"pr_state_id":2,"user_id":1}`

### `bexio_quote_accept`

Accept Quote · Write

Mark a quote as accepted by the customer.
Returns an object with success.
Use bexio_quote_accept when the customer agrees, then bexio_quote_invoice_create.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `quote_id` (`integer`, required): Quote ID, from bexio_quotes_list. Example: 7

Example input: `{"quote_id":7}`

### `bexio_quote_create`

Create Quote · Write

Create a draft quote for a contact with line items.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_quote_create for a new quote, then bexio_quote_issue and bexio_quote_send.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `contact_id` (`integer`, required): Customer contact ID. Example: 4
- `user_id` (`integer`, required): ID of the bexio user responsible for the document, from bexio_users_list. Example: 1
- `api_reference` (`string`, optional): This field can only be read and edited by the api. It can be used to save references to other systems. Example: example
- `bank_account_id` (`integer`, optional): References a bank account object. Example: 1
- `contact_address_manual` (`string`, optional): This field can be used to set a contact address manually. If not in use or null the invoice address of the contact will be taken. Example: UTA Immobilien AG
Stadtturmstrasse 15
5400 Baden
- `contact_sub_id` (`integer`, optional): References a contact object. Example: 12345
- `currency_id` (`integer`, optional): References a currency object. Example: 1
- `delivery_address_manual` (`string`, optional): This field can be used to set a delivery address manually if delivery_address_type is set to 1. If not in use or null the invoice address will be taken. Example: UTA Immobilien AG
Stadtturmstrasse 15
5400 Baden
- `delivery_address_type` (`integer`, optional): | value | description | |-------|-------------| | 0 | use invoice address | | 1 | use custom address |. One of: 0, 1. Example: 0. One of: `0`, `1`.
- `document_nr` (`string`, optional): Can not be used if “automatic numbering” is activated in frontend-settings. Required if “automatic numbering” deactivated. https://help.bexio.com/s/article/000001784. Example: AN-00001
- `footer` (`string`, optional): Text below the positions on the document. Example: Payable within 30 days.
- `header` (`string`, optional): Text above the positions on the document. Example: Thank you for your order.
- `is_valid_from` (`string`, optional): Document date, YYYY-MM-DD. Example: 2026-11-16
- `is_valid_until` (`string`, optional): Quote valid until, YYYY-MM-DD. Example: 2026-12-16
- `language_id` (`integer`, optional): References a language object. Example: 1
- `mwst_is_net` (`boolean`, optional): This value affects the total if the field mwst_type has been set to 0. false = Taxes are included in the total true = Taxes will be added to the total. Example: True
- `mwst_type` (`integer`, optional): VAT handling: 0 including taxes, 1 excluding taxes, 2 exempt. One of: 0, 1, 2. Example: 0. One of: `0`, `1`, `2`.
- `payment_type_id` (`integer`, optional): References a payment type object. Example: 1
- `positions` (`array`, optional): Line items. A custom position is {"type": "KbPositionCustom", "amount": "1", "unit_price": "1200.00", "tax_id": 16, "text": "Design work"}; an item position uses "type": "KbPositionArticle" with article_id. Example: [{"type": "KbPositionCustom", "amount": "1", "unit_price": "1200.00", "tax_id": 16, "text": "Design work"}]
- `pr_project_id` (`integer`, optional): References a project object. Example: 12345
- `show_position_taxes` (`boolean`, optional): If true, show the tax of each position on the document. Example: false
- `template_slug` (`string`, optional): References a document template slug. Example: 581a8010821e01426b8b456b
- `title` (`string`, optional): Document title. Example: Website redesign

Example input: `{"contact_id":4,"user_id":1}`

### `bexio_quote_invoice_create`

Create Invoice from Quote · Write

Create an invoice from an accepted quote.
Returns an object with id, document_nr, title, contact_id, contact_sub_id, user_id, project_id, pr_project_id, logopaper_id, language_id, and more.
Use bexio_quote_invoice_create to bill a quote without retyping positions.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `quote_id` (`integer`, required): Quote ID, from bexio_quotes_list. Example: 7
- `positions` (`array`, optional): Please note that the positions array can be omitted to create a document with all positions from the source document. Example: [{"key": "value"}]

Example input: `{"quote_id":7}`

### `bexio_quote_issue`

Issue Quote · Write

Issue a draft quote.
Returns an object with success.
Use bexio_quote_issue before sending a quote.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `quote_id` (`integer`, required): Quote ID, from bexio_quotes_list. Example: 7

Example input: `{"quote_id":7}`

### `bexio_quote_send`

Send Quote · Write

Email an issued quote to the customer.
Returns an object with success.
Use bexio_quote_send to deliver a quote. This emails the recipient.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `message` (`string`, required): Email text; it must contain the placeholder [Network Link]. Example: Please find our quote here: [Network Link]
- `quote_id` (`integer`, required): Quote ID, from bexio_quotes_list. Example: 7
- `recipient_email` (`string`, required): Recipient email address. Example: info@muster.ch
- `subject` (`string`, required): Email subject. Example: Quote AN-00007
- `attach_pdf` (`boolean`, optional): Attach PDF directly to the email. Example: True
- `mark_as_open` (`boolean`, optional): If true, mark the document as open (issued) when sending. Example: true

Example input: `{"message":"<message>","quote_id":7,"recipient_email":"<recipient_email>","subject":"<subject>"}`

### `bexio_task_create`

Create Task · Write

Create a task, optionally linked to a contact or project.
Returns an object with id, user_id, finish_date, subject, place, info, contact_id, sub_contact_id, project_id, pr_project_id, and more.
Use bexio_task_create to add a to-do.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `subject` (`string`, required): Task subject. Example: Call Muster AG about renewal
- `user_id` (`integer`, required): Assigned user ID. Example: 1
- `contact_id` (`integer`, optional): References a contact object. Example: 1
- `finish_date` (`string`, optional): Due date and time. Example: 2026-11-20 10:00:00
- `info` (`string`, optional): Text of the task or note. Example: Discuss the renewal offer
- `pr_project_id` (`integer`, optional): References a project object. Example: 12345
- `remember_time_id` (`integer`, optional): Is required if have_remember is set to true. Example: 12345
- `remember_type_id` (`integer`, optional): Is required if have_remember is set to true. Example: 12345
- `sub_contact_id` (`integer`, optional): References a contact object. Example: 12345
- `todo_priority_id` (`integer`, optional): Task priority ID. Example: 2
- `todo_status_id` (`integer`, optional): Task status ID: 1 open, 2 done. Example: 1

Example input: `{"subject":"<subject>","user_id":1}`

### `bexio_task_update`

Update Task · Write

Update a task, for example its status or due date.
Returns an object with id, user_id, finish_date, subject, place, info, contact_id, sub_contact_id, project_id, pr_project_id, and more.
Use bexio_task_update to complete or reschedule a task.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `task_id` (`integer`, required): Task ID. Example: 8
- `contact_id` (`integer`, optional): References a contact object. Example: 1
- `finish_date` (`string`, optional): Due date and time. Example: 2026-11-20 10:00:00
- `info` (`string`, optional): Text of the task or note. Example: Discuss the renewal offer
- `pr_project_id` (`integer`, optional): References a project object. Example: 12345
- `remember_time_id` (`integer`, optional): Is required if have_remember is set to true. Example: 12345
- `remember_type_id` (`integer`, optional): Is required if have_remember is set to true. Example: 12345
- `sub_contact_id` (`integer`, optional): References a contact object. Example: 12345
- `subject` (`string`, optional): Subject. Example: Call Muster AG about renewal
- `todo_priority_id` (`integer`, optional): Task priority ID. Example: 2
- `todo_status_id` (`integer`, optional): Task status ID: 1 open, 2 done. Example: 2
- `user_id` (`integer`, optional): References a user object. Example: 1

Example input: `{"task_id":8}`

### `bexio_timesheet_create`

Create Timesheet · Write

Record a time entry, optionally on a contact or project.
Returns an object with id, user_id, status_id, client_service_id, text, allowable_bill, charge, contact_id, sub_contact_id, pr_project_id, and more.
Use bexio_timesheet_create to log work.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `allowable_bill` (`boolean`, required): If true, the time is billable. Example: true
- `client_service_id` (`integer`, required): Work type (business activity) ID. Example: 1
- `tracking` (`object`, required): Time tracking: {"type": "duration", "date": "YYYY-MM-DD", "duration": "HH:MM"} or {"type": "range", "start": "<datetime>", "end": "<datetime>"}. Example: {"type": "duration", "date": "2026-11-16", "duration": "01:30"}
- `user_id` (`integer`, required): User who worked. Example: 1
- `charge` (`string`, optional): Hourly charge override as a decimal string. Example: 150.00
- `contact_id` (`integer`, optional): References a contact object. Example: 2
- `pr_project_id` (`integer`, optional): Project ID. Example: 2
- `status_id` (`integer`, optional): References a timesheet status object. Example: 4
- `sub_contact_id` (`integer`, optional): References a contact object. Example: 12345
- `text` (`string`, optional): Description of the work. Example: Workshop with customer

Example input: `{"allowable_bill":true,"client_service_id":1,"tracking":{"type":"duration","date":"2026-11-16","duration":"01:30"},"user_id":1}`

### `bexio_timesheet_update`

Update Timesheet · Write

Update a time entry.
Returns an object with id, user_id, status_id, client_service_id, text, allowable_bill, charge, contact_id, sub_contact_id, pr_project_id, and more.
Use bexio_timesheet_update to correct logged time.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `timesheet_id` (`integer`, required): Timesheet ID. Example: 10
- `allowable_bill` (`boolean`, optional): If true, the time is billable. Example: true
- `charge` (`string`, optional): Hourly charge override as a decimal string. Example: 150.00
- `client_service_id` (`integer`, optional): References a business activity object. Example: 1
- `contact_id` (`integer`, optional): References a contact object. Example: 2
- `pr_project_id` (`integer`, optional): References a project object. Example: 12345
- `status_id` (`integer`, optional): References a timesheet status object. Example: 4
- `sub_contact_id` (`integer`, optional): References a contact object. Example: 12345
- `text` (`string`, optional): Description of the work. Example: Workshop with customer
- `tracking` (`object`, optional): Time tracking object. Example: {"type": "duration", "date": "2026-11-16", "duration": "02:00"}
- `user_id` (`integer`, optional): References a user object. Example: 1

Example input: `{"timesheet_id":10}`

### `bexio_contact_delete`

Delete Contact · Destructive

Archive a contact (bexio keeps it as archived).
Returns an object with success.
Use bexio_contact_delete to remove a contact from active lists.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`integer`, required): Contact ID, from bexio_contacts_list or bexio_contacts_search. Example: 4

Example input: `{"contact_id":4}`

### `bexio_invoice_cancel`

Cancel Invoice · Destructive

Cancel an issued invoice.
Returns an object with success.
Use bexio_invoice_cancel when an issued invoice should no longer be paid.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID, from bexio_invoices_list. Example: 12

Example input: `{"invoice_id":12}`

### `bexio_invoice_delete`

Delete Invoice · Destructive

Permanently delete a draft invoice.
Returns an object with success.
Use bexio_invoice_delete for drafts. Use bexio_invoice_cancel for issued invoices.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`integer`, required): Invoice ID, from bexio_invoices_list. Example: 12

Example input: `{"invoice_id":12}`

### `bexio_timesheet_delete`

Delete Timesheet · Destructive

Delete a time entry.
Returns an object with success.
Use bexio_timesheet_delete to remove a wrong entry.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `timesheet_id` (`integer`, required): Timesheet ID. Example: 10

Example input: `{"timesheet_id":10}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
