Skip to main content
Create a single tag. The command takes one required flag, --name, and returns the new tag’s ID. Use the ID in subsequent tag attach calls when you want to attach the same tag to many channels or events without rediscovering it by name. Tag names are not unique in TalkValue, so creating the same name twice produces two distinct tags. Use tag list --name <substring> before creating if you want to reuse an existing tag.

​
Synopsis

talkvalue path tag create --name <name>

​
Options

FlagTypeDescription
-n, --name <name>string (required)Display name for the tag. Shows up on the dashboard exactly as written.

​
Examples

​
1. Create a single tag

talkvalue path tag create --name "LinkedIn"
Prints the new tag as a single-record table: ID and name.

​
2. Capture the ID for the rest of the script

tag_id=$(
  talkvalue path tag create --name "Customer Day 2026" --json \
    | jq -r '.data.id'
)
echo "Created tag $tag_id"
talkvalue path tag attach 18 --tag-id "$tag_id"
talkvalue path tag attach 19 --tag-id "$tag_id"
Use this pattern when you need to attach the same tag to several known sources in one go.

​
3. Bulk-create from a list

while read -r name; do
  talkvalue path tag create --name "$name" --json | jq -r '.data | [.id, .name] | @tsv'
done < tags.txt
Reads names line by line, prints each new id\tname pair. Pair with tee tag-ids.txt to keep the mapping for later attach steps.

​
Response

{
  "data": {
    "id": 42,
    "name": "LinkedIn"
  }
}
The shape matches every other tag response in the API. Re-use the id when scripting many attaches.

​
See also