• Products
  • Documentation
  • Resources

Manage an organization with the admin APIs

API keys allow you to manage your organization via the admin APIs. You can update organization settings with the organizations REST API and manage user accounts with the user management REST API. To make requests to the API with the client of your choice, create an API key.

To create an API key:

  1. Go to admin.atlassian.com. Select your organization if you have more than one.

  2. Select Settings > API keys.

  3. Select Create API key in the top right.

  4. Enter a name that you’ll remember to identify the API key.

  5. By default, the key expires one week from today. If you’d like to change the expiration date, pick a new date under Expires on. You’re unable to select a date longer than a year from the date of creation.

  6. Select Create to save the API key.

  7. Copy the values for your Organization ID and API key. You'll need those to use the API key.

    Note: Make sure you store these values in a safe place, as we won't show them to you again.

  8. Select Done. The key will appear in your list of API keys.

To revoke an API key, select Revoke next to the API key.

Revoking an API key is permanent. It may take up to 10 minutes for a revoked key to stop working.

Additional Help