Skip to content
← Back to documentation
Technical Reference

Bokio

Bokio is an accounting software platform which offers digital bookkeeping, invoicing, and financial management tools to help simplify accounting processes.

CategoryAccounting
Authenticationcustom
Version0.1.0
Published scopes0 published scopes
Last updatedSeptember 19, 2026

Overview

Bokio

This CDK catalogue package is pinned to @activepieces/piece-bokio@0.1.0 and declares 11 declared actions and no declared triggers. Its definition is derived from the exact reviewed Activepieces source.

Provider runtime verification is recorded separately when an approved test connection is exercised; this catalogue entry does not claim that verification.

Technical guide

Technical reference

  • Package: @activepieces/piece-bokio@0.1.0
  • Exact artifact digest: sha256:9dae787678773948c589d6d51b918ebc616ed65827b1071fd00549a522b25a96
  • Source: the exact reviewed Activepieces source
  • Authentication, action and trigger schemas are taken from the exact pinned package.

Capability summary

Authenticationcustom
Supported objects11
Supported actions11
TriggersNone published

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • Company ID Required
  • API Key Required · protected credential

Supported objects

ObjectReadWriteNotes
Create Customer Yes No
Create Invoice Yes No
Add line item to invoice Yes No
Create an item Yes No
Create a journal entry Yes No
Update an invoice Yes No
Find Customer Yes No
Get Draft Invoice by Customer Name Yes No
Get an invoice Yes No
Get a journal entry Yes No
Custom API Call Yes No

Supported actions

Create Customer · Read

Creates a new customer in Bokio

create_customer · Risk: low · Retry: safe

Inputs

  • customerName · string · Required, Name of the customer
  • type · string · Required, Type of the customer
  • vatNumber · string · Optional, Customer VAT number
  • orgNumber · string · Optional, Customer organization number
  • paymentTerms · string · Optional, Payment terms for the customer. Payment terms for the invoices. Payment terms can both take free text or days, in digits, until the payment is due.
  • customerNumber · string · Optional, Customer number (optional)
  • email · string · Optional, Customer email address
  • phone · string · Optional, Customer phone number
  • lin1 · string · Optional, Customer address line 1
  • line2 · string · Optional, Customer address line 2
  • zipCode · string · Optional, Customer zip code
  • city · string · Optional, Customer city
  • country · string · Optional, Customer country (ISO 3166-1 alpha-2 country code)
Create Invoice · Read

Creates a new draft invoice in Bokio

create_invoice · Risk: low · Retry: safe

Inputs

  • invoiceType · string · Optional, Type of invoice
  • customerRef · string · Optional, UUID of the customer
  • invoiceDate · string · Required, Invoice date (YYYY-MM-DD)
  • dueDate · string · Required, Due date (YYYY-MM-DD)
  • orderNumberReference · string · Optional, The order number associated with the invoice
  • currency · string · Optional, ISO 4217 currency code (e.g., SEK, EUR, USD)
  • currencyRate · number · Optional, Currency rate (defaults to 1)
  • itemType · string · Required, Type of the line item
  • dynamicProps · object · Optional, Configure item details based on item type
Add line item to invoice · Read

Adds a line item to an existing draft invoice

add_line_item_to_invoice · Risk: low · Retry: safe

Inputs

  • invoiceId · string · Required, Select the invoice
  • itemType · string · Required, Type of the item
  • dynamicProps · object · Optional, Configure item details based on item type
Create an item · Read

Creates a new item in Bokio

create_an_item · Risk: low · Retry: safe

Inputs

  • itemType · string · Required, Type of the item
  • dynamicProps · object · Optional, Configure item details based on item type
Create a journal entry · Read

Creates a new journal entry in Bokio

create_ajournal_entry · Risk: low · Retry: safe

Inputs

  • title · string · Optional, Title of the journal entry
  • date · string · Required, Journal entry date (YYYY-MM-DD)
  • items · array · Optional, Journal entry items as JSON array. Each item should have: account (account number), debit (optional), credit (optional)
Update an invoice · Read

Updates an existing draft invoice in Bokio

update_an_invoice · Risk: low · Retry: safe

Inputs

  • invoiceId · string · Required, Select the invoice
  • invoiceType · string · Optional, Type of invoice
  • customerRef · string · Optional, UUID of the customer
  • invoiceDate · string · Required, Invoice date (YYYY-MM-DD)
  • dueDate · string · Required, Due date (YYYY-MM-DD)
  • orderNumberReference · string · Optional, The order number associated with the invoice
  • currency · string · Optional, ISO 4217 currency code (e.g., SEK, EUR, USD)
  • currencyRate · number · Optional, Currency rate
  • lineItemsJson · string · Optional, Line items as JSON array. Each item should have: itemRef (object with id), description, quantity, unitPrice, unit, itemType (PRODUCT or SERVICE), vat
Find Customer · Read

Find customers in Bokio by filtering and pagination

find_customer · Risk: low · Retry: safe

Inputs

  • filterType · string · Optional, Type of filter to use
  • filterValue · string · Optional, Value to filter by
  • page · number · Optional, Page number (defaults to 1)
  • pageSize · number · Optional, Number of items per page (max 100, defaults to 25)
Get Draft Invoice by Customer Name · Read

Get all draft invoices for a customer by customer name

get_draft_invoice_by_customer_name · Risk: low · Retry: safe

Inputs

  • customerName · string · Required, Name of the customer to find draft invoices for
  • page · number · Optional, Page number (defaults to 1)
  • pageSize · number · Optional, Number of items per page (max 100, defaults to 25)
Get an invoice · Read

Retrieve a specific invoice by its ID

get_an_invoice · Risk: low · Retry: safe

Inputs

  • invoiceId · string · Required, The ID of the invoice to retrieve
Get a journal entry · Read

Retrieve a specific journal entry by its ID

get_ajournal_entry · Risk: low · Retry: safe

Inputs

  • journalEntryId · string · Required, UUID of the journal entry
Custom API Call · Read

Make a custom API call to a specific endpoint

custom_api_call · Risk: low · Retry: safe

Inputs

  • url · object · Required
  • method · string · Required
  • headers · object · Optional, Authorization headers are injected automatically from your connection.
  • queryParams · object · Optional, Appended to the URL as ?key=value.
  • body_type · string · Optional
  • body · object · Optional
  • response_is_binary · boolean · Optional, Enable for files like PDFs, images, etc.
  • failsafe · boolean · Optional, On a failed request, output the error instead of failing the step.
  • timeout · number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).
  • followRedirects · boolean · Optional, Follow 3xx redirects instead of returning them as the response.

Setup

Setup

Create a tenant connection only in the consuming Studio instance when this connector is made available there. Credentials remain in that tenant's Vault-backed connection and are not stored in CDK package metadata.

Limitations

The package has passed deterministic offline package-load and contract validation. No provider credentials, provider API call or live webhook delivery is represented by this release state.