---
title: influxctl management create
description: The influxctl management create command creates a management token used to perform administrative tasks in an InfluxDB Cloud Dedicated cluster.
url: https://docs.influxdata.com/influxdb3/cloud-dedicated/reference/cli/influxctl/management/create/
estimated_tokens: 672
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud-dedicated/reference/cli/influxctl/management/create/
date: '2026-05-15T15:46:14-06:00'
lastmod: '2026-05-15T15:46:14-06:00'
---

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.

> [!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.

The optional `--expires-at` flag defines the token expiration date and time.
Provide an RFC3999 date string–for example: `2026-06-09T00: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

```sh
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             |

*Also see [`influxctl` global flags](/influxdb3/cloud-dedicated/reference/cli/influxctl/#global-flags).*

## Examples

* [Create a management token with no expiration](#create-a-management-token-with-no-expiration)
* [Create a management token with an expiration and description](#create-a-management-token-with-an-expiration-and-description)

### Create a management token with no expiration

```sh
influxctl management create
```

### Create a management token with an expiration and description

```sh
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:`2026-06-09T00:00:00Z`.
* `TOKEN_DESCRIPTION`:
  Management token description.

#### Related

* [Create a management token](/influxdb3/cloud-dedicated/admin/tokens/management/create/)
| Flag |  | Description |
| --- | --- | --- |
| Flag |  | Description |
|  | --description | Management token description |
|  | --expires-at | Token expiration date |
|  | --format | Output format ( table   (default)  or  json ) |
| -h | --help | Output command help |