Add People Group | trebellar

import { TrebellarApiClient } from "@trebellar/api-sdk";
async function main() {
    const client = new TrebellarApiClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.peopleGroups.addPeopleGroup({
        name: "Engineering Team",
        status: "PEOPLE_GROUP_STATUS_ACTIVE",
        parentId: "grp_technology_dept",
        description: "Software development and infrastructure team",
        properties: {
            color: "#2196F3",
        },
        externalId: "DEPT_ENG",
    });
}
main();

{
  "id": "grp_engineering_team",
  "name": "Engineering Team",
  "status": "PEOPLE_GROUP_STATUS_UNKNOWN",
  "path": "/departments/technology/engineering",
  "parentId": "grp_technology_dept",
  "avatarUrl": "https://example.com/team-avatar.png",
  "description": "Software development and infrastructure team",
  "properties": {
    "color": "#2196F3"
  },
  "externalId": "DEPT_ENG"
}

import { TrebellarApiClient } from "@trebellar/api-sdk";
async function main() {
    const client = new TrebellarApiClient({
        apiKey: "YOUR_API_KEY_HERE",
    });
    await client.peopleGroups.addPeopleGroup({
        name: "Engineering Team",
        status: "PEOPLE_GROUP_STATUS_ACTIVE",
        parentId: "grp_technology_dept",
        description: "Software development and infrastructure team",
        properties: {
            color: "#2196F3",
        },
        externalId: "DEPT_ENG",
    });
}
main();

{
  "id": "grp_engineering_team",
  "name": "Engineering Team",
  "status": "PEOPLE_GROUP_STATUS_UNKNOWN",
  "path": "/departments/technology/engineering",
  "parentId": "grp_technology_dept",
  "avatarUrl": "https://example.com/team-avatar.png",
  "description": "Software development and infrastructure team",
  "properties": {
    "color": "#2196F3"
  },
  "externalId": "DEPT_ENG"
}

Authentication

X-Trebellar-Api-Keystring

API Key authentication via header

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired

statusenumRequired

Allowed values:

idstringOptional

pathstringOptional

parentIdstringOptional

avatarUrlstringOptional

descriptionstringOptional

propertiesobjectOptional

Custom properties for group visualization and categorization

externalIdstringOptional

Response

Successful people-group inserted

idstring

namestring

statusenum

Allowed values:

pathstring

parentIdstring

avatarUrlstring

descriptionstring

propertiesobject

Custom properties for group visualization and categorization

externalIdstring

Errors

400

Bad Request Error

404

Not Found Error

500

Internal Server Error

1	import { TrebellarApiClient } from "@trebellar/api-sdk";
2
3	async function main() {
4	const client = new TrebellarApiClient({
5	apiKey: "YOUR_API_KEY_HERE",
6	});
7	await client.peopleGroups.addPeopleGroup({
8	name: "Engineering Team",
9	status: "PEOPLE_GROUP_STATUS_ACTIVE",
10	parentId: "grp_technology_dept",
11	description: "Software development and infrastructure team",
12	properties: {
13	color: "#2196F3",
14	},
15	externalId: "DEPT_ENG",
16	});
17	}
18	main();

1	{
2	"id": "grp_engineering_team",
3	"name": "Engineering Team",
4	"status": "PEOPLE_GROUP_STATUS_UNKNOWN",
5	"path": "/departments/technology/engineering",
6	"parentId": "grp_technology_dept",
7	"avatarUrl": "https://example.com/team-avatar.png",
8	"description": "Software development and infrastructure team",
9	"properties": {
10	"color": "#2196F3"
11	},
12	"externalId": "DEPT_ENG"
13	}