---
title: "Add a company"
method: POST
path: "/api/v4/f/{firm_id}/companies"
tags: ["Companies"]
---

# Add a company

`POST /api/v4/f/{firm_id}/companies`

Add a company. <br>
<b>Required scope(s):</b> `administration:write`

## Path parameters

- `firm_id` integer, required

## Headers

- `Accept` string
- `Content-Type` string

## Response `201`

Successful response

- object
  - `id` integer — company_id
  - `name` string
  - `created_at` string
  - `organisation_form` string
  - `country` string
  - `city` string
  - `street` string
  - `file_code` string
  - `company_type` string
  - `periods_per_year` integer
  - `sync_reference` string
  - `accountancy_synchronisation_reference` string
  - `accountancy_synchronisation_entity_id` integer
  - `accountancy_synchronisation_entity_type` string
  - `account_mapping_list_id` integer
  - `administration_synchronisation_reference` string
  - `administration_synchronisation_entity_id` integer
  - `company_template_id` integer
  - `folder_name` string
  - `vat` string
  - `visible_for_contributors` boolean
  - `currency` string
  - `group_ids` integer[]
  - `year_end` string
  - `first_name` string
  - `last_name` string
  - `national_insurance_number` string

---

[API](https://skmtc.net/silverfin/apis/silverfin-api.md) · [All operations](https://skmtc.net/silverfin/apis/silverfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/silverfin/silverfin-api/revisions/61e058ce0d3f/schema)