Skip to main content

Celonis Product Documentation

Creating API keys


Where possible, we recommend using the OAuth 2.0 authentication method. For more information, see: Using OAuth 2.0.

Using API keys is an effective and secure method of communicating between your and external systems, such as an identity provider. They are created within an individual user profile in your Celonis Platform , with the key’s permissions mirroring those of the user who created them.

For security reasons, an API key is only displayed at the time it is created. Therefore you must create a new key if you no longer have access to any you create.

Using an API key is one of the methods involved in configuring SCIM API (for provisioning and deprovisioning users and groups in your ), with the alternative being creating and granting permissions to application keys.

Admins can also receive a system notification whenever an admin creates or deletes an API key. See: System notifications


To create an API key as an admin:

  1. Click your profile and select Edit Profile.

    add something here.
  2. Enter a new API key name and click Create API Key.

  3. Copy the API key displayed.


    You can only view an application key once, so make sure to copy it when you create it. If you don't have a copy of the keys on your list, you'll need to create a new one.

  4. Add the API key to the authorization header of your requests using the following format:

    Authorization: Bearer API_KEY