---
title: "Create a tag"
method: POST
path: "/tags"
tags: ["Tags"]
---

# Create a tag

`POST /tags`

## Request body

- object
  - `tag_group_id` string, required — The tag group this tag belongs to. The business entity is inferred from the tag group.
  - `label` string, required
  - `label_translations` Translations, nullable
    - `en` string
    - `fr` string
  - `description` string, nullable
  - `description_translations` Translations, nullable
    - `en` string
    - `fr` string
  - `expense_segment` string, nullable — The expense code piece this tag contributes to a generated expense code in the journal entry report, pulled in by a `tag_group` segment of an accounting code rule's expense template.
  - `liability_segment` string, nullable — The liability code piece this tag contributes to a generated liability code in the journal entry report, pulled in by a `tag_group` segment of an accounting code rule's liability template.
  - `integrations` object — Identifiers for this tag in external accounting integrations, used to sync tags imported from those systems.
    - `xero` object
      - `id` string
    - `quickbooks` object
      - `id` string

## Response `201`

Created

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"tag"`).
  - `data` Tag
    - `label` string
    - `label_translations` Translations, nullable
      - `en` string
      - `fr` string
    - `label_translated` string — The translation of the `label` property for the request locale. Computed using the values in `label` and `label_translations` and the value of the request's `Accept-Language` header.
    - `description` string, nullable
    - `description_translations` Translations, nullable
      - `en` string
      - `fr` string
    - `description_translated` string — The translation of the `description` property for the request locale. Computed using the values in `description` and `description_translations` and the value of the request's `Accept-Language` header.
    - `archived_at` string, dateTime, nullable — When set, the tag is archived and excluded from index listings by default.
    - `is_deletable` boolean — A tag may not be deleted while it is assigned to any active allocation.
    - `expense_segment` string, nullable — The expense code piece this tag contributes to a generated expense code, pulled in by a `tag_group` segment of an accounting code rule's expense template.
    - `liability_segment` string, nullable — The liability code piece this tag contributes to a generated liability code, pulled in by a `tag_group` segment of an accounting code rule's liability template.
    - `integrations` object, nullable — Identifiers for this tag in external accounting integrations, used to sync tags imported from those systems.
      - `xero` object, nullable
        - `id` string — The unique identifier of the object in Nmbr.
      - `quickbooks` object, nullable
        - `id` string — The unique identifier of the object in Nmbr.
    - `tag_group` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"tag_group"`).
    - `business_entity` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"business_entity"`).
    - `created_at` string, dateTime — The date and time the object was created in Nmbr.
    - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

---

[API](https://skmtc.dev/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.dev/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/revisions/29c2d6ac7131/schema)