WhatGHL icon

WhatGHL

Send actions to WhatGHL API

Actions42

🏷️ **LABELS** · Create Label

AI-generated

Summary

Create a new label in the WhatGHL system with a specified name and optional color to categorize chats or contacts.

Inputs

  • Session Mode — Select how to choose the sender session: Auto, By Session Name, or by selecting from available sessions.
  • Session — Specify the session ID when 'Select Session' mode is used.
  • Session Name — Specify the WAHA session name when using 'By Session Name' mode.
  • Label Name (required) — Name of the label to create (e.g., 'VIP').
  • Label Color — Optional numeric color ID for the label, as used by WAHA.

Output shape

a single JSON object representing the created label with its details.

If the maximum number of labels (20) is reached, a warning JSON with status 'warning' is returned instead of an error. No pagination is involved.

Examples

Example 1: Create a label named VIP with color ID 1 using automatic session selection.

Session Mode: Auto; Label Name: VIP; Label Color: 1

Links

Discussion