Skip to content
Acme Help Center

Create an API token

An API token lets an application authenticate to the Acme API on your behalf. You create tokens in Settings → Developer, choose which scopes each token has, and copy the token value once when it’s generated.

Before you start, make sure the Developer area is available to you — see Enable developer mode.

Generate a token

Section titled “Generate a token”
  1. Go to Settings → Developer.
  2. Select Generate Token.
  3. Enter a Token Name that describes where you’ll use it (for example, “Production integration”). The name is just for you — it helps you recognize the token later.
  4. Choose one or more Scopes. Scopes control what the token is allowed to do — see Token scopes. A token needs at least one scope.
  5. Select Generate.

After generating, select Copy and close to copy the token to your clipboard and dismiss the dialog.

Use your token

Section titled “Use your token”

Send the token in the Authorization header of your API requests as a Bearer token:

Authorization: Bearer YOUR_TOKEN

For the available endpoints and full request and response details, see the API reference.

Manage your tokens

Section titled “Manage your tokens”

Back on the Developer page, each token shows its name, a short hint of its value, when it was created, when it was last used, its scopes, and how much of its monthly request limit it has used. From here you can:

  • Rename a token — select the edit (pencil) icon next to it to update its display name.
  • Revoke a token — see below.

Revoke a token

Section titled “Revoke a token”

Revoke a token when it’s no longer needed or may have been exposed.

  1. Go to Settings → Developer.
  2. Find the token in the list and select the revoke (trash) icon.
  3. Confirm in the dialog.
Section titled “Related”