curl --request POST \
--url https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Teams",
"description": "Organizational teams.",
"icon": {
"emoji": "👥",
"color": "#3B82F6"
}
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories"
payload = {
"name": "Teams",
"description": "Organizational teams.",
"icon": {
"emoji": "👥",
"color": "#3B82F6"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Teams',
description: 'Organizational teams.',
icon: {emoji: '👥', color: '#3B82F6'}
})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories', 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://api.gowindmill.com/api/v2/c/{companyId}/groups/categories",
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([
'name' => 'Teams',
'description' => 'Organizational teams.',
'icon' => [
'emoji' => '👥',
'color' => '#3B82F6'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://api.gowindmill.com/api/v2/c/{companyId}/groups/categories"
payload := strings.NewReader("{\n \"name\": \"Teams\",\n \"description\": \"Organizational teams.\",\n \"icon\": {\n \"emoji\": \"👥\",\n \"color\": \"#3B82F6\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Teams\",\n \"description\": \"Organizational teams.\",\n \"icon\": {\n \"emoji\": \"👥\",\n \"color\": \"#3B82F6\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories")
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'
request.body = "{\n \"name\": \"Teams\",\n \"description\": \"Organizational teams.\",\n \"icon\": {\n \"emoji\": \"👥\",\n \"color\": \"#3B82F6\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "11111111-1111-4111-8111-111111111111"
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "CONFLICT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "<string>",
"requestId": "<string>"
}
}Create an employee group category
Creates a company-wide category with a trimmed name of 1–100 characters, an optional description up to 500 characters, and a required emoji/color or glyph/color icon. Names must be unique among active company categories, ignoring case; conflicts return 409. Empty descriptions are saved as null. Requires permission to manage group categories (groups.manage_categories). Returns HTTP 200 with the new category UUID.
curl --request POST \
--url https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Teams",
"description": "Organizational teams.",
"icon": {
"emoji": "👥",
"color": "#3B82F6"
}
}
'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories"
payload = {
"name": "Teams",
"description": "Organizational teams.",
"icon": {
"emoji": "👥",
"color": "#3B82F6"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Teams',
description: 'Organizational teams.',
icon: {emoji: '👥', color: '#3B82F6'}
})
};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories', 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://api.gowindmill.com/api/v2/c/{companyId}/groups/categories",
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([
'name' => 'Teams',
'description' => 'Organizational teams.',
'icon' => [
'emoji' => '👥',
'color' => '#3B82F6'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://api.gowindmill.com/api/v2/c/{companyId}/groups/categories"
payload := strings.NewReader("{\n \"name\": \"Teams\",\n \"description\": \"Organizational teams.\",\n \"icon\": {\n \"emoji\": \"👥\",\n \"color\": \"#3B82F6\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Teams\",\n \"description\": \"Organizational teams.\",\n \"icon\": {\n \"emoji\": \"👥\",\n \"color\": \"#3B82F6\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/groups/categories")
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'
request.body = "{\n \"name\": \"Teams\",\n \"description\": \"Organizational teams.\",\n \"icon\": {\n \"emoji\": \"👥\",\n \"color\": \"#3B82F6\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "11111111-1111-4111-8111-111111111111"
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "CONFLICT",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "<string>",
"requestId": "<string>"
}
}Authorizations
Use an API key or OAuth access token. Enter only the token in the authorization dialog; requests send it as Authorization: Bearer <TOKEN>.
Create an API key in your workspace's Settings → API keys. Keys start with wm_api_ and only work in the workspace where they were created. Read-only keys can read data; creating, updating, or deleting data requires a read-write key.
Authorization: Bearer wm_api_example
OAuth access tokens are issued for connected Windmill applications.
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
Both token types use the authenticated user's workspace permissions. Each endpoint's permission requirements and the sharing settings of the requested items still apply.
Path Parameters
Body
Category name must be unique among active company categories, ignoring case.
Was this page helpful?