Skip to main content
POST
Update the customer-facing name or company settings

Authorizations

Authorization
string
header
required

Firebase ID token from an interactive portal session. Required for interactive operations (payroll, company settings, API-key management) and invoice decisions allowed by the member's review permissions.

Body

application/json
customer_id
string

Target company. Optional for single-company sessions.

display_name
string

Customer-facing calling/trading name. Empty clears it and falls back to the legal name.

Maximum string length: 70
fiscal_year_start_month
integer

Month the fiscal year starts (1-12).

vat_period_months
integer

VAT reporting period length in months (e.g. 1, 3, 12).

vat_period_valid_from
string

Period-aligned effective date, YYYY-MM-DD.

invoice_approval_policy
enum<string>

Whether a draft sales invoice needs an approver before it is issued. Admin only — a request that includes this field is refused for anyone else, including an approver.

Available options:
off,
required
purchase_invoice_approval_policy
enum<string>

Review required for received purchase invoices. Admin only. Approval needs an active approver. Verify and approve needs an active verifier and a different active approver.

Available options:
off,
approval,
verify_and_approve

Response

Updated company profile.

The company's registered details and accounting configuration.

customer_id
string
display_name
string

Customer-facing calling name; falls back to legal_name.

business_id
string

Finnish business ID (Y-tunnus).

vat_number
string
country_code
string
currency
string
fiscal_year_start_month
integer

Month the fiscal year starts (1-12).

vat_period_months
integer

VAT reporting period length in months.

vat_period_source
enum<string>

Where the VAT period setting comes from.

Available options:
dated,
column,
default
vat_period_next
object

First recorded VAT period change that takes effect after today.

company_form
string
statement_format
string
invoice_approval_policy
enum<string>

Whether a draft sales invoice needs an approver before it is issued.

Available options:
off,
required
invoice_approval_editable
boolean

Whether this caller may change the invoice approval policy. Admin only, and never an API key: an approver must not be able to switch off the gate they exist to hold.

purchase_invoice_approval_policy
enum<string>

Direct handling, approval, or delivery verification followed by approval.

Available options:
off,
approval,
verify_and_approve
purchase_invoice_approval_editable
boolean

Whether this interactive admin may change purchase approval.

editable
boolean

Whether the caller may change settings (false for API keys).

display_name_editable
boolean

Whether this interactive caller may change the customer-facing name; false for API keys and connectors.