docs-v2/content/shared/influxdb3-cli/create/token.md

The influxdb3 create token command creates a new authentication token. This returns the raw token string. Use it to authenticate future CLI commands and API requests.

[!Important] InfluxDB displays the raw token string only once. Be sure to copy and securely store it.

Usage

influxdb3 create token <SUBCOMMAND>

Commands

Command	Description
--admin	Create an admin token for the {{< product-name >}} server.
{{% show-in "enterprise" %}}	--permission	Create a resource token with fine-grained access permissions.

Options

Option		Description
	--admin	Create an admin token
-h	--help	Print help information

Examples

Create an admin token

influxdb3 create token --admin

The output is the raw token string you can use to authenticate future CLI commands and API requests. For CLI commands, use the --token option or the INFLUXDB3_AUTH_TOKEN environment variable to pass the token string.

Use the token to create a database

{{% code-placeholders "YOUR_ADMIN_TOKEN|DATABASE_NAME" %}}

influxdb3 create database \
  --token ADMIN_TOKEN \
  DATABASE_NAME

{{% /code-placeholders %}}

Replace the following:

• {{% code-placeholder-key %}}ADMIN_TOKEN{{% /code-placeholder-key %}}: Your InfluxDB admin token
• {{% code-placeholder-key %}}DATABASE_NAME{{% /code-placeholder-key %}}: Name for your new database

[!Note] Set the token as an environment variable to simplify repeated CLI commands:

export INFLUXDB3_AUTH_TOKEN=YOUR_ADMIN_TOKEN