Skip to main content
POST
/
v0
/
tag-groups
Create a new tag group
curl --request POST \
  --url https://external.pleo.io/v0/tag-groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json;charset=UTF-8' \
  --data '
{
  "archived": true,
  "code": "<string>",
  "name": "<string>",
  "metadata": {}
}
'
{
  "data": {
    "archived": false,
    "code": "5524f270-6c21-11ee-b962-0242ac120002",
    "companyId": "c04c7e9e-6c15-11ee-b962-0242ac120003",
    "createdAt": "2023-08-23T03:11:48Z",
    "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
    "metadata": {
      "externalExtraId": "f302f9ec-6c17-11ee-b962-0242ac120002"
    },
    "name": "Projects",
    "updatedAt": "2023-08-23T03:11:48Z",
    "totalTagsCount": 4
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
company_id
string<uuid>

Unique identifier of the company the tag group will be associated with.

Body

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

Boolean flag used to determine whether the tag group is archived.

​
code
string
required

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

​
name
string
required

User readable name of the tag group.

​
metadata
object

Place to store additional information about the tag group.

Response

default - application/json;charset=UTF-8

default response

​
data
object
required