Documentation

influxctl management create

The influxctl management create command creates a management token to be used with an InfluxDB Cloud Dedicated 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.

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.

The optional --expires-at flag defines the token expiration date and time. Provide an RFC3999 date string–for example: 2025-11-01T00:00:00Z. 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.

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.

Usage

influxctl management create [flags]

Flags

FlagDescription
--descriptionManagement token description
--expires-atToken expiration date
--formatOutput format (table (default) or json)
-h--helpOutput command help

Examples

Create a management token with no expiration

influxctl management create

Create a management token with an expiration and description

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

Replace the following:

  • RFC3339_EXPIRATION: An RFC3339 date string to expire the token at–for example: 2025-11-01T00:00:00Z.
  • TOKEN_DESCRIPTION: Management token description.

Was this page helpful?

Thank you for your feedback!


New in InfluxDB 3.6

Key enhancements in InfluxDB 3.6 and the InfluxDB 3 Explorer 1.4.

See the Blog Post

InfluxDB 3.6 is now available for both Core and Enterprise. This release introduces the 1.4 update to InfluxDB 3 Explorer, featuring the beta launch of Ask AI, along with new capabilities for simple startup and expanded functionality in the Processing Engine.

For more information, check out:

InfluxDB Docker latest tag changing to InfluxDB 3 Core

On February 3, 2026, the latest tag for InfluxDB Docker images will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments.

If using Docker to install and run InfluxDB, the latest tag will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments. For example, if using Docker to run InfluxDB v2, replace the latest version tag with a specific version tag in your Docker pull command–for example:

docker pull influxdb:2