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 unique per workspace, matched case-insensitively after trimming. Running tag create with a name that already exists returns that existing tag, so the command is safe to re-run in a script.

Synopsis

Options

Examples

1. Create a single tag

Prints the new tag as a single-record table: ID and name.

2. Capture the ID for the rest of the script

Use this pattern when you need to attach the same tag to several known sources in one go.

3. Bulk-create from a list

Reads names line by line and prints each id\tname pair. Re-running the loop returns the same IDs. Pair it with tee tag-ids.txt to keep the mapping for later attach steps.

Response

The shape matches every other tag response in the API. Re-use the id when scripting many attaches.

See also