---
title: "Update company accounting settings (admin/approver only)"
method: POST
path: "/company/settings"
tags: ["Company"]
---

# Update company accounting settings (admin/approver only)

`POST /company/settings`

## Request

- Base URL: `https://api.app.lastaccountingcompany.com/portal`
- URL: `https://api.app.lastaccountingcompany.com/portal/company/settings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lastaccountingcompany/apis/lac-customer-api/docs/company/settings/post.ts> (a function with typed inputs; its response is checked against the schema)

Changes the fiscal year start month and/or VAT period length. Requires an interactive admin/approver session — NOT available to API keys (even write-scoped ones), which receive 403. `vat_period_valid_from` must be a period-aligned `YYYY-MM-DD` date.

## Request body

- object
  - `customer_id` string: Target company. Optional for single-company sessions.
  - `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`.

## Response `200`

Updated company profile.

- CompanyProfile: The company's registered details and accounting configuration.
  - `customer_id` string
  - `legal_name` string
  - `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` 'dated' | 'column' | 'default': Where the VAT period setting comes from.
  - `company_form` string
  - `statement_format` string
  - `editable` boolean: Whether the caller may change settings (false for API keys).

## Other responses

- `401`: Missing or invalid bearer token.
- `403`: Insufficient scope or role — e.g. a read-scoped key on a mutating method, or an API key on an admin/approver-only endpoint.

---

[API](https://skmtc.dev/lastaccountingcompany/apis/lac-customer-api.md) - [All operations](https://skmtc.dev/lastaccountingcompany/apis/lac-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lastaccountingcompany/apis/lac-customer-api/revisions/52e277b4f031?raw)