Creates a new tag group resource

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": {}
}
'

import requests

url = "https://external.pleo.io/v0/tag-groups"

payload = {
    "archived": True,
    "code": "<string>",
    "name": "<string>",
    "metadata": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json;charset=UTF-8"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json;charset=UTF-8'
  },
  body: JSON.stringify({archived: true, code: '<string>', name: '<string>', metadata: {}})
};

fetch('https://external.pleo.io/v0/tag-groups', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://external.pleo.io/v0/tag-groups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'archived' => true,
    'code' => '<string>',
    'name' => '<string>',
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json;charset=UTF-8"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://external.pleo.io/v0/tag-groups"

	payload := strings.NewReader("{\n  \"archived\": true,\n  \"code\": \"<string>\",\n  \"name\": \"<string>\",\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json;charset=UTF-8")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://external.pleo.io/v0/tag-groups")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json;charset=UTF-8")
  .body("{\n  \"archived\": true,\n  \"code\": \"<string>\",\n  \"name\": \"<string>\",\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://external.pleo.io/v0/tag-groups")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json;charset=UTF-8'
request.body = "{\n  \"archived\": true,\n  \"code\": \"<string>\",\n  \"name\": \"<string>\",\n  \"metadata\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "archived": false,
    "code": "5524f270-6c21-11ee-b962-0242ac120002",
    "companyId": "c04c7e9e-6c15-11ee-b962-0242ac120003",
    "createdAt": "2023-08-23T03:11:48.000Z",
    "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
    "metadata": {
      "externalExtraId": "f302f9ec-6c17-11ee-b962-0242ac120002"
    },
    "name": "Projects",
    "updatedAt": "2023-08-23T03:11:48.000Z"
  }
}

POST

tag-groups

Creates a new tag group resource

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": {}
}
'

import requests

url = "https://external.pleo.io/v0/tag-groups"

payload = {
    "archived": True,
    "code": "<string>",
    "name": "<string>",
    "metadata": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json;charset=UTF-8"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json;charset=UTF-8'
  },
  body: JSON.stringify({archived: true, code: '<string>', name: '<string>', metadata: {}})
};

fetch('https://external.pleo.io/v0/tag-groups', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://external.pleo.io/v0/tag-groups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'archived' => true,
    'code' => '<string>',
    'name' => '<string>',
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json;charset=UTF-8"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://external.pleo.io/v0/tag-groups"

	payload := strings.NewReader("{\n  \"archived\": true,\n  \"code\": \"<string>\",\n  \"name\": \"<string>\",\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json;charset=UTF-8")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://external.pleo.io/v0/tag-groups")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json;charset=UTF-8")
  .body("{\n  \"archived\": true,\n  \"code\": \"<string>\",\n  \"name\": \"<string>\",\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://external.pleo.io/v0/tag-groups")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json;charset=UTF-8'
request.body = "{\n  \"archived\": true,\n  \"code\": \"<string>\",\n  \"name\": \"<string>\",\n  \"metadata\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "archived": false,
    "code": "5524f270-6c21-11ee-b962-0242ac120002",
    "companyId": "c04c7e9e-6c15-11ee-b962-0242ac120003",
    "createdAt": "2023-08-23T03:11:48.000Z",
    "id": "c04c7e9e-6c15-11ee-b962-0242ac120002",
    "metadata": {
      "externalExtraId": "f302f9ec-6c17-11ee-b962-0242ac120002"
    },
    "name": "Projects",
    "updatedAt": "2023-08-23T03:11:48.000Z"
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

company_id

string<uuid>

Body

application/json;charset=UTF-8

archived

boolean

required

code

string

required

name

string

required

metadata

object

Show child attributes

Response

default - application/json;charset=UTF-8

default response

data

object

required

Show child attributes

ABOUT THE PLEO API

EXPORT API

TAGS API

TAX CODE API

APP MARKETPLACE API

EMPLOYEES API

BOOKKEEPING CORE API

WEBHOOK SUBSCRIPTIONS API

COMPANIES API

VENDORS API

PLEO.IO API (DEPRECATED)

Creates a new tag group resource

Authorizations

Query Parameters

Body

Response