Create a new tag

This endpoint allows for the creation of a new Tag and its attribute values.

POST /tag-groups/{tagGroupId}/tags

Create a new tag

cURL

curl --request POST \
  --url https://openapi.pleo.io/v1/tag-groups/{tagGroupId}/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "attributeValues": [
    {
      "attributeId": "0f0e000-000d-0d00-000b-00db0d000fae",
      "value": "<string>"
    }
  ]
}
'

200

{
  "id": "0f0e000-000d-0d00-000b-00db0d000fae",
  "tagGroupId": "0f0e000-000d-0d00-000b-00db0d000fae",
  "attributeValues": [
    {
      "attributeId": "0f0e000-000d-0d00-000b-00db0d000fae",
      "value": "<string>"
    }
  ],
  "displayOrder": 123,
  "hidden": true
}

Authorizations

Authorization · string · header · required

Open API Bearer token

Path Parameters

tagGroupId · string · required

Unique UUID of the tag group.

Example:

"0f0e000-000d-0d00-000b-00db0d000fae"

Body

application/json

attributeValues · object[] · required

These are the attributes and their values assigned to this tag

Show child attributes

Response

200

application/json

Tag group has been created

id · string · required

This is the internal pleo identifier of the tag

Example:

"0f0e000-000d-0d00-000b-00db0d000fae"

tagGroupId · string · required

This is the internal pleo identifier of the tag group this tag belongs to

Example:

"0f0e000-000d-0d00-000b-00db0d000fae"

attributeValues · object[] · required

These are the attributes and their values assigned to this tag

Show child attributes

displayOrder · number · required

This is the display order position for this tag when displayed in a list.

hidden · boolean · required

This flag specifies if the tag is hidden and not visible for use in pleo when tagging expenses.