/

Manage your API keys and secret keys

This article helps you:

  • Manage your API keys and secret keys

Note

You should review the keys and tokens documentation before you make any changes to your keys.

Amplitude’s self-service key management page helps you create, disable, or delete both API keys and secret keys at the project level. Only users who received the feature flag from Amplitude can access this page. All changes are permanent.

You can:

  • Create and name multiple API keys and secret keys
  • View a log of the creator, and the last action taken on the key
  • Revoke API access

Note

Once you revoke an API key, you can't undo it. However, you may still be able to see the key value.

Manage your keys

To manage your keys, follow these steps:

  1. Select Organization settings in the upper navigation.
  2. Select API Keys. In the API Keys tab, you can see the legacy API key. This key was created along with the project. You can't revoke this key.

api_secret_manage.png

Generate an API key

To generate an API key, follow these steps:

  1. Select the project you’re interested in.
  2. Click Generate API Key.
  3. Name the API key.

api_secret_generate_api.png

You can copy this API Key to store or use it elsewhere.

Revoke an API key

To revoke an API key, follow these steps:

  1. Select the API key.
  2. Confirm that you want to revoke the key.

api_secret_revoke1.png

After you click Revoke, the key is permanently unusable. You still retain the API key for your records.

 api_secret_revoke2.png

Generate a secret key

To generate a secret key, follow these steps:

  1. Select the appropriate project.
  2. Click Generate Secret Key.
  3. Name the secret key and copy it into your records. Amplitude doesn't store secret keys, and there is no way to retrieve it. (The Key ID is a unique identifier for your secret key, but it's not the key itself.)

api_secret_generate_secret1.png

api_secret_generate_secret2.png

Delete a secret key

To delete a secret key, select the secret key you want to delete, then type “DELETE” to confirm your intent.

You can't use, see, or recover a secret key after deleting it.

Limitations

  • You can have a maximum of 50 active keys
  • Key creation is instantaneous
  • It can take up to 6 hours to delete a key
Was this page helpful?

Thanks for your feedback!

July 16th, 2024

Need help? Contact Support

Visit Amplitude.com

Have a look at the Amplitude Blog

Learn more at Amplitude Academy

© 2024 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.