Skip to main content
POST
/
v0
/
tag-groups
/
{groupId}
/
tags
Create a new tag for a tag group
curl --request POST \
  --url https://external.pleo.io/v0/tag-groups/{groupId}/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json;charset=UTF-8' \
  --data '
{
  "archived": false,
  "code": "12345",
  "name": "Lunch allowance",
  "otherDimensionValues": [
    "value1",
    "value2"
  ]
}
'
{
  "data": {
    "archived": false,
    "code": "12345",
    "createdAt": "2023-08-23T03:11:48Z",
    "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
    "updatedAt": "2023-08-23T03:11:48Z",
    "name": "Lunch allowance"
  }
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token authentication. Include the token in the Authorization header as: Bearer <token>

Path Parameters

​
groupId
string<uuid>
required

Unique identifier of the tag group.

Body

application/json;charset=UTF-8
​
archived
boolean
required

Boolean flag used to determine whether the tag is archived.

Example:

false

​
code
string
required

Code used in the external ERP/accounting system to identify the tag.

Example:

"12345"

​
name
string

User readable name of the tag.

Example:

"Lunch allowance"

​
otherDimensionValues
string[]

Dimension values outside the two main dimensions ordered by display order. Values not provided will be given empty values.Values will be ignored if there is not enough dimensions to add them to.

Dimension values outside the two main dimensions ordered by display order. Values not provided will be given empty values.Values will be ignored if there is not enough dimensions to add them to.

Example:
["value1", "value2"]

Response

Tag created successfully.

​
data
object
required