docs-v2/content/influxdb3/clustered/reference/cli/influxctl/management/create.md

title	description	menu	weight	related
influxctl management create	The `influxctl management create` command creates a management token used to perform administrative tasks in an InfluxDB cluster.	influxdb3_clustered parent influxctl management	301	/influxdb3/clustered/admin/tokens/management/create/

The influxctl management create command creates a management token to be used with an {{< product-name omit=" Clustered" >}} cluster. Management tokens authorize a user to perform administrative tasks on the InfluxDB instance such as creating and deleting databases, managing users, and other administrative tasks.

{{% note %}} Management tokens do not provide access to databases or data in databases. Only database tokens with "read" or "write" permissions can access data in databases. {{% /note %}}

The optional --expires-at flag defines the token expiration date and time. Provide an RFC3999 date string--for example: {{< datetime/current-date offset=1 >}}. If not set, the token does not expire until revoked.

The --format flag lets you print the output in other formats. The json format is available for programmatic parsing by other tooling. Default: table.

{{% note %}}

Store secure tokens in a secret store

Management token strings are returned only on token creation. We recommend storing management tokens in a secure secret store. {{% /note %}}

Usage

influxctl management create [flags]

Flags

Flag		Description
	--description	Management token description
	--expires-at	Token expiration date
	--format	Output format (table (default) or json)
-h	--help	Output command help

{{% caption %}} Also see influxctl global flags. {{% /caption %}}

Examples

• Create a management token with no expiration
• Create a management token with an expiration and description

Create a management token with no expiration

influxctl management create

Create a management token with an expiration and description

{{% code-placeholders "RFC3339_EXPIRATION|TOKEN_DESCRIPTION" %}}

influxctl management create \
  --expires-at RFC3339_EXPIRATION \
  --description "TOKEN_DESCRIPTION"

{{% /code-placeholders %}}

Replace the following:

• {{% code-placeholder-key %}}RFC3339_EXPIRATION{{% /code-placeholder-key %}}: An RFC3339 date string to expire the token at--for example: {{< datetime/current-date offset=1 >}}.
• {{% code-placeholder-key %}}TOKEN_DESCRIPTION{{% /code-placeholder-key %}}: Management token description.