BObokio
tag-groups

Create a tag group

Creates a new tag group for the company.

A tag group represents a category or dimension used to classify journal entries, such as "Project", "Cost center", or "Department".

The company must have the Tags feature enabled in their price plan.

Scope: tags:write

post/companies/{companyId}/tag-groups

Request

  • Base URL
    https://api.bokio.se/v1
  • URL
    https://api.bokio.se/v1/companies/{companyId}/tag-groups
  • Auth
    HTTP bearer

Request body

namestring required

Name of the tag group

aliasstring required

Short alias for quick tagging (max 3 characters, unique per company)

dimensionNumberinteger nullable

Dimension number for SIE file export/import compatibility.

Reserved numbers per SIE file format: 1 = Cost center, 2 = Cost carrier, 6 = Project, 7 = Employee, 8 = Customer, 9 = Supplier, 10 = Invoice, 20+ = Freely available.

Example request

{
  "name": "Project",
  "alias": "@",
  "dimensionNumber": 6
}

Response

Tag group created

idstring uuid

Unique identifier of the tag group

namestring

Name of the tag group

aliasstring

Short alias for quick tagging (max 3 characters, unique per company)

dimensionNumberinteger nullable

Dimension number for SIE file export/import compatibility.

Reserved numbers per SIE file format: 1 = Cost center, 2 = Cost carrier, 6 = Project, 7 = Employee, 8 = Customer, 9 = Supplier, 10 = Invoice, 20+ = Freely available.

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Project",
  "alias": "@",
  "dimensionNumber": 6,
  "tags": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Project Alpha"
    },
    {
      "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "name": "Project Beta"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.