curl --request PUT \
--url https://sandbox.nmbr.co/services/payroll/tag_groups/{tag_group} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label": "Cost Centre"
}
'{
"id": "<id>",
"object": "tag_group",
"data": {
"label": "Cost Centre",
"label_translations": null,
"label_translated": "Cost Centre",
"description": null,
"description_translations": null,
"description_translated": null,
"color": null,
"archived_at": null,
"is_deletable": true,
"is_component_locked": false,
"is_journal_entry_dimension": false,
"integrations": {
"xero": {
"id": null,
"type": null
},
"quickbooks": {
"type": null
}
},
"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": "/tag_groups/<id>"
}
}Update a tag group
curl --request PUT \
--url https://sandbox.nmbr.co/services/payroll/tag_groups/{tag_group} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label": "Cost Centre"
}
'{
"id": "<id>",
"object": "tag_group",
"data": {
"label": "Cost Centre",
"label_translations": null,
"label_translated": "Cost Centre",
"description": null,
"description_translations": null,
"description_translated": null,
"color": null,
"archived_at": null,
"is_deletable": true,
"is_component_locked": false,
"is_journal_entry_dimension": false,
"integrations": {
"xero": {
"id": null,
"type": null
},
"quickbooks": {
"type": null
}
},
"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": "/tag_groups/<id>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
255Response
OK
The unique identifier of the object in Nmbr.
The type of the object in Nmbr ("tag_group").
Hide child attributes
Hide child attributes
255The 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.
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.
A hex colour code for the tag group (e.g. #AABBCC or #ABC). Used for display.
7When set, the tag group is archived and excluded from index listings by default.
A tag group may not be deleted while it is the primary tag group or any of its tags are assigned to active allocations.
When true, the tags within this group cannot be modified through the embedded portal. Tags can still be managed through the API.
When true, this tag group is used as a dimension in journal entry reports. A business entity can have up to three journal entry dimensions.
Identifiers and object types for this tag group in external accounting integrations, used to sync tag groups imported from those systems. QuickBooks does not expose a group-level identifier, so only the type is stored for QuickBooks.
Hide child attributes
Hide child attributes
The date and time the object was created in Nmbr.
The date and time the object was last updated in Nmbr.