Create a token

Use the influxctl token create command to create a token that grants access to databases in your InfluxDB Cloud Dedicated cluster.

1. If you haven’t already, download and install the influxctl CLI.

2. Run the influxctl token create command and provide the following:

   • Token permissions (read and write per database)
     • --read-database: Grant read permissions to a database
     • --write-database: Grant write permissions to a database
   • Token description

influxctl token create \
  --read-database <DATABASE_NAME> \
  --write-database <DATABASE_NAME> \
  <TOKEN_DESCRIPTION>

The command returns the token ID and the token string. This is the only time the token string is available in plain text.

InfluxDB might take some time to synchronize new tokens. If a new token doesn’t immediately work for querying or writing, wait a few seconds and try again.

Example token creation commands

influxctl token create \
  --read-database mydb \
  --write-database mydb \
  "Read/write token for mydb"

influxctl token create \
  --read-database mydb \
  "Read-only token for mydb"

influxctl token create \
  --read-database mydb1 \
  --read-database mydb2 \
  "Read-only token for mydb1 and mydb2"

influxctl token create \
  --read-database mydb1 \
  --read-database mydb2 \
  --write-database mydb2 \
  "Read-only on mydb1, Read/write on mydb2"