---
title: influxdb3 create token --admin
description: The influxdb3 create token --admin subcommand creates a named token with full administrative privileges for server actions.
url: https://docs.influxdata.com/influxdb3/cloud/reference/cli/influxdb3/create/token/admin/
estimated_tokens: 843
product: InfluxDB 3 Cloud
version: cloud
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud/reference/cli/influxdb3/create/token/admin/
date: '2026-07-16T10:40:31-05:00'
lastmod: '2026-07-16T10:40:31-05:00'
---

Create a named administrator token.

> [!Note]
> #### Operator tokens in InfluxDB 3 Cloud
>
> InfluxData manages the operator token for your InfluxDB 3 Cloud instance.
> The operator token never expires and cannot be edited or deleted.

## Usage

```
influxdb3 create token --admin [OPTIONS]
```

## Options

|    Option    |                                                 Description                                                 |
|--------------|-------------------------------------------------------------------------------------------------------------|
|   `--name`   |                                              Name of the token                                              |
|  `--expiry`  |                     Expires in `duration`–for example, 10d for 10 days or 1y for 1 year                     |
|   `--host`   |The host URL of the running InfluxDB 3 server [env: `INFLUXDB3_HOST_URL=`] [default: `http://127.0.0.1:8181`]|
|  `--token`   |                          An existing administrator token for the InfluxDB 3 server                          |
|  `--tls-ca`  |              An optional arg to use a custom CA for useful for testing with self-signed certs               |
|  `--format`  |                          Output format for token [possible values: `json`, `text`]                          |
|`-h`, `--help`|                                           Print help information                                            |
| `--help-all` |                                    Print more detailed help information                                     |

## Examples

* [Create a named administrator token](#create-a-named-administrator-token)
* [Use the token to create a database](#use-the-token-to-create-a-database)

### Create a named administrator token

Use an existing administrator token to create a named administrator token.

```bash
influxdb3 create token \
  --admin \
  --token ADMIN_TOKEN \
  --name TOKEN_NAME \
  --expiry DURATION
```

Replace the following:

* `ADMIN_TOKEN`: Your InfluxDB administrator token
* `TOKEN_NAME`: Name for your new administrator token
* `DURATION`: Duration for the token to remain valid, in [humantime](https://docs.rs/humantime/latest/humantime/fn.parse_duration.html) format (for example, `10d` for 10 days or `1y` for 1 year).

### Use the token to create a database

```bash
influxdb3 create database \
  --token ADMIN_TOKEN \
  DATABASE_NAME
```

Replace the following:

* `ADMIN_TOKEN`: Your InfluxDB administrator token
* `DATABASE_NAME`: Name for your new database

> [!Note]
> #### Use CLI environment variables
>
> Set the token as an environment variable to simplify repeated CLI commands:
>
> ```
> export INFLUXDB3_AUTH_TOKEN=ADMIN_TOKEN
> ```
| Option | Description |
| --- | --- |
| Option | Description |
| --name | Name of the token |
| --expiry | Expires in  duration –for example, 10d for 10 days or 1y for 1 year |
| --host | The host URL of the running InfluxDB 3 server [env:  INFLUXDB3_HOST_URL= ] [default:  http://127.0.0.1:8181 ] |
| --token | An existing administrator token for the InfluxDB 3 server |
| --tls-ca | An optional arg to use a custom CA for useful for testing with self-signed certs |
| --format | Output format for token [possible values:  json ,  text ] |
| -h ,  --help | Print help information |
| --help-all | Print more detailed help information |