tag/new

Creates a tag inside a project.

What is a tag?

A tag is a project-level label used to classify posts, organize them into folders, and support automated tagging rules.

Method and path

POST /tag/new

Authentication

Authentication is required. See Authentication.

Permissions

Accessible to tier 1, 2, and 3 users.

Request headers

Header	Required	Description
X-Api-Key or X_API_KEY	yes	API key.
Content-Type	yes	application/json.

Request body

Field	Type	Required	Description
project_id	integer	yes	Project identifier.
tag_label	string	yes	Tag label.
tag_folder_id	integer	yes	Target folder identifier.
public_tag	boolean	no	Public flag. If omitted, the stored value is false.
alert_whitelist	boolean	no	Alert whitelist flag. If omitted, the stored value is false.

Example request

curl -X POST "$SIGNAL_API_BASE_URL/tag/new" \
  -H "X-Api-Key: $SIGNAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": 123,
    "tag_label": "Example Tag",
    "tag_folder_id": 7
  }'

{
  "project_id": 123,
  "tag_label": "Example Tag",
  "tag_folder_id": 7,
  "public_tag": false,
  "alert_whitelist": false
}

Example response

{
  "id": 456,
  "label": "Example Tag",
  "alert_whitelist": 0,
  "public_tag": 0,
  "folder": {
    "id": 7,
    "label": "Example Folder"
  }
}

Response fields

Field	Type	Description
id	integer	Tag identifier.
label	string	Tag label.
alert_whitelist	integer	Flag returned as 0 or 1.
public_tag	integer	Flag returned as 0 or 1.
folder	object	Folder assigned to the tag.

Notes

• The response returns the created tag with its resolved folder object.