Update the customer-facing name or company settings
Changes the customer-facing company name, fiscal year start month, and/or VAT period length. An operator may change display_name alone; fiscal/VAT and other statutory settings require an interactive admin or existing broad-approver session. API keys receive 403. display_name is the optional trading name used as the primary seller name on outgoing invoices; the legal name and Business ID remain on every issued invoice. vat_period_valid_from must be a period-aligned YYYY-MM-DD date.
Authorizations
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
Target company. Optional for single-company sessions.
Customer-facing calling/trading name. Empty clears it and falls back to the legal name.
70Month the fiscal year starts (1-12).
VAT reporting period length in months (e.g. 1, 3, 12).
Period-aligned effective date, YYYY-MM-DD.
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.
off, required 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.
off, approval, verify_and_approve Response
Updated company profile.
The company's registered details and accounting configuration.
Customer-facing calling name; falls back to legal_name.
Finnish business ID (Y-tunnus).
Month the fiscal year starts (1-12).
VAT reporting period length in months.
Where the VAT period setting comes from.
dated, column, default First recorded VAT period change that takes effect after today.
Whether a draft sales invoice needs an approver before it is issued.
off, required 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.
Direct handling, approval, or delivery verification followed by approval.
off, approval, verify_and_approve Whether this interactive admin may change purchase approval.
Whether the caller may change settings (false for API keys).
Whether this interactive caller may change the customer-facing name; false for API keys and connectors.