Skip to main content
POST
/
tags
Create a tag
curl --request POST \
  --url https://sandbox.nmbr.co/services/payroll/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tag_group_id": "<id>",
  "label": "Engineering"
}
'
{
  "id": "<id>",
  "object": "tag",
  "data": {
    "label": "Engineering",
    "label_translations": null,
    "label_translated": "Engineering",
    "description": null,
    "description_translations": null,
    "description_translated": null,
    "archived_at": null,
    "is_deletable": null,
    "integrations": {
      "xero": {
        "id": null
      },
      "quickbooks": {
        "id": null
      }
    },
    "tag_group": {
      "id": "<id>",
      "object": "tag_group",
      "links": {
        "self": "/tag_groups/<id>"
      }
    },
    "business_entity": {
      "id": "<id>",
      "object": "business_entity",
      "links": {
        "self": "/business_entities/<id>"
      }
    },
    "created_at": "2026-01-01T00:00:00.000000Z",
    "updated_at": "2026-01-01T00:00:00.000000Z"
  },
  "links": {
    "self": "/tags/<id>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
tag_group_id
string
required

The tag group this tag belongs to. The business entity is inferred from the tag group.

​
label
string
required
Maximum string length: 255
​
label_translations
object

Optional translations for the label property.

​
description
string | null
​
description_translations
object

Optional translations for the description property.

​
integrations
object

Identifiers for this tag in external accounting integrations, used to sync tags imported from those systems.

Response

201 - application/json

Created

​
id
string
read-only

The unique identifier of the object in Nmbr.

​
object
string
read-only

The type of the object in Nmbr ("tag").

​
data
Tag · object