docs-v2/content/shared/influxdb3-admin/tokens/admin/create.md

Use the influxdb3 create token --admin subcommand or the HTTP API to create an admin token for your {{< product-name omit="Clustered" >}} instance. An admin token grants full access to all actions for your InfluxDB 3 instance.

[!Note]

Store secure tokens in a secret store

Token strings are returned only on token creation. We recommend storing database tokens in a secure secret store. Anyone with access to the admin token has full control over your {{< product-name >}} instance. If you lose the admin token string, you must regenerate the token.

Create an admin token

{{< tabs-wrapper >}} {{% tabs %}} CLI HTTP API {{% /tabs %}} {{% tab-content %}}

Use the influxdb3 create token --admin command:

influxdb3 create token --admin

The output contains the token string in plain text.

To use the token as the default for later commands, and to persist the token across sessions, assign the token string to the INFLUXDB3_AUTH_TOKEN environment variable. {{% /tab-content %}} {{% tab-content %}} Use the following endpoint to create an admin token:

{{% show-in "core" %}} {{% api-endpoint method="POST" endpoint="/api/v3/configure/token/admin" api-ref="/influxdb3/version/api/v3/#operation/PostCreateAdminToken" %}}

curl -X POST "http://{{< influxdb/host >}}/api/v3/configure/token/admin" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'

{{% /show-in %}} {{% show-in "enterprise" %}} {{% api-endpoint method="POST" endpoint="/api/v3/enterprise/configure/token/admin" api-ref="/influxdb3/version/api/v3/#operation/PostCreateAdminToken" %}}

curl -X POST "http://{{< influxdb/host >}}/api/v3/{{< product-key >}}/configure/token/admin" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'

{{% /show-in %}} {{% /tab-content %}} {{< /tabs-wrapper >}}