BObokio
agency-companies

Create a client company

Create a brand-new Bokio company and connect it to the agency as a client.

The company is created on a free trial. The organization number must be a valid organization number.

Scope: agency-companies:write

post/agencies/{agencyId}/companies

Request

  • Base URL
    https://api.bokio.se/v1
  • URL
    https://api.bokio.se/v1/agencies/{agencyId}/companies
  • Auth
    HTTP bearer

Request body

namestring required

Name of the company

ownerEmailstring email required

Email of the company owner. Must belong to an existing user that is a member of the agency. This user becomes the owner of the created company so they can access it.

organizationNumberstring required

Organization number of the company

vatNumberstring nullable

VAT number of the company

companyType'proprietorship' | 'limitedCompany' | 'limitedPartnership' | 'partnership' | 'cooperative' | 'nonProfitAssociation' | 'communityAssociation' | 'religiousCommunity' required

Company type of the company

accountingMethod'cash' | 'accrual' required

The accounting method used by the company.

vatSetting'yearly' | 'quarterly' | 'monthly' | 'notRegisteredForVat' required

The VAT reporting period of the company.

fiscalYearStartstring

The start of the company's fiscal year as a month and day in MM-DD format. Defaults to 01-01 when omitted.

Example request

{
  "name": "Client Company AB",
  "ownerEmail": "owner@example.com",
  "organizationNumber": "556677-8899",
  "vatNumber": "SE556677889901",
  "companyType": "limitedCompany",
  "accountingMethod": "accrual",
  "vatSetting": "monthly",
  "address": {
    "line1": "Älvsborgsvägen 10",
    "city": "Göteborg",
    "postalCode": "123 45",
    "country": "SE"
  },
  "fiscalYearStart": "01-01"
}

Response

Client company created

idstring uuid required

Unique identifier for the company

namestring required

Name of the company

organizationNumberstring required

Organization number of the company

vatNumberstring nullable

VAT number of the company

companyType'proprietorship' | 'limitedCompany' | 'limitedPartnership' | 'partnership' | 'cooperative' | 'nonProfitAssociation' | 'communityAssociation' | 'religiousCommunity' required

Company type of the company

Example response

{
  "id": "55c899c5-82b2-47fa-9c51-e35fc9b26443",
  "name": "Client Company AB",
  "organizationNumber": "556677-8899",
  "vatNumber": "SE556677889901",
  "companyType": "limitedCompany",
  "address": {
    "line1": "Älvsborgsvägen 10",
    "city": "Göteborg",
    "postalCode": "123 45",
    "country": "SE"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.