> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytalkvalue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# talkvalue path tag create

> Create a new Path tag by name and get back the tag ID for attaching to channels or events.

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`](/cli/commands/path/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>`](/cli/commands/path/tag/index) before creating if you want to reuse an existing tag.

## Synopsis

```bash theme={null}
talkvalue path tag create --name <name>
```

## Options

| Flag                | Type              | Description                                                             |
| ------------------- | ----------------- | ----------------------------------------------------------------------- |
| `-n, --name <name>` | string (required) | Display name for the tag. Shows up on the dashboard exactly as written. |

## Examples

### 1. Create a single tag

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```jsonc theme={null}
{
  "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

* [`tag attach`](/cli/commands/path/tag/attach). Attach the new tag to a channel or event.
* [Tags](/path/concepts/tags). When and why to use tags in Path.
* [`path channel list`](/cli/commands/path/channel/list). Find channel IDs to attach the tag to.