Skip to main content
POST
Create a label group
In the Heliyos MCP server: heliyos_labels_create.

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.

Body

application/json
name
string
required

The group's name, 1 to 200 characters. Must not equal the name of another group in the workspace (exact, case-sensitive match).

Required string length: 1 - 200
Example:

"Pricing questions"

description
string
required

What the group covers, 1 to 1,000 characters. Heliyos reads it when it classifies email threads, so say plainly what belongs in the group.

Required string length: 1 - 1000
Example:

"Emails asking about prices, discounts, quotes or billing terms."

isActive
boolean

true (the default) for an active group, false to create it paused.

Example:

true

labels
object[]

The group's labels, up to 500. Names must be unique within the group, ignoring case. Defaults to none.

Maximum array length: 500

Response

The created label group.

meta
object
required
data
object
required