---
title: "Create a tag group"
method: POST
path: "/companies/{companyId}/tag-groups"
tags: ["tag-groups"]
---

# Create a tag group

`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

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`

## Request body

- TagGroupWrite
  - `name` string, required: Name of the tag group
  - `alias` string, required: Short alias for quick tagging (max 3 characters, unique per company)
  - `dimensionNumber` integer, 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.

## Response `200`

Tag group created

- TagGroup
  - `id` string, uuid: Unique identifier of the tag group
  - `name` string: Name of the tag group
  - `alias` string: Short alias for quick tagging (max 3 characters, unique per company)
  - `dimensionNumber` integer, 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.
  - `tags` TagValue[]: The tags (values) within this tag group
    - `id` string, uuid: Unique identifier of the tag
    - `name` string: Name of the tag

## Other responses

- `400`: Validation error. Possible reasons: - Missing required fields - Duplicate alias (must be unique per company) - Duplicate dimension number (must be unique per company)
- `403`: Forbidden. The company's price plan does not include API access, or the integration does not have the required scope. See [price plan requirements](price-plan-requirements#handling-403-responses) for details on how to handle this response.

---

[API](https://skmtc.dev/bokio/apis/company-api.md) - [All operations](https://skmtc.dev/bokio/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bokio/apis/company-api/revisions/9395020f3da2?raw)