Articles in this section

Set up a connection to Celonis

Naga Sri Hari Gonaboyina
Updated

Celonis software offers process mining and execution management solutions. It helps organizations analyze and optimize their business processes using data from their IT systems (such as SAP, Oracle, Salesforce, etc.).

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required *authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose your Celonis API type:

  • Intelligence: Access KPIs, alerts, and signal logic. Use this to trigger workflows or extract decision intelligence from Celonis.

  • Data push: Push external data into Celonis in real time. Use this to keep data models and analyses up to date with live system data.

Intelligence API type 

Domain * 

Enter your Celonis account domain. For example, if your account URL is https://celigo.us-1.celonis.cloud/, then celigo.us-1.celonis.cloud is your domain.

Auth type * 

Select your Celonis API authentication type (Custom, Token, or OAuth2.0).

App key * 

Enter your Celonis App key.

Multiple layers of protection, including AES 256 encryption, are in place to keep your App key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve the App key:

API key * 

Enter your Celonis API key.

Multiple layers of protection, including AES 256 encryption, are in place to keep your API key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve the API key: 

OAuth 2.0 client * 

Select the OAuth 2.0 client that stores the client ID and client secret provided to you by Celonis.

How to retrieve the client ID and client secret 

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource

Valid domain names *

Enter your Celonis account domain. For example, if your account URL is https://celigo.us-1.celonis.cloud, then celigo.us-1.celonis.cloud is the valid domain name.

Scopes * 

Scopes are OAuth 2.0 permissions that Celonis defines to limit access to your account.

How to configure scopes 

Data push API type

Domain * 

Enter your Celonis account domain. For example, if your account URL is https://celigo.us-1.celonis.cloud/, then celigo.us-1.celonis.cloud is your domain.

Auth type * 

Select your Celonis API authentication type (Custom or Token).

Pool ID * 

Enter your Celonis pool ID.

How to retrieve your pool ID: 

App key * 

Enter your Celonis App key.

Multiple layers of protection, including AES 256 encryption, are in place to keep your App key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve the App key:

API key * 

Enter your Celonis API key.

Multiple layers of protection, including AES 256 encryption, are in place to keep your API key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve the API key: 

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the Custom, Token, or the OAuth 2.0 auth universal connector's respective documentation.

How to retrieve the API key

  1. Sign in to your Celonis admin account.

  2. Navigate to Profile > Edit profile.

  3. Enter a New API key name.

  4. Click Create API key.

  5. Copy the API key.

How to retrieve the client ID and client secret

  1. Sign in to your Celonis admin account.

  2. Navigate to Admin and settings > Applications.

  3. Click + Add new application.

  4. Select OAuth client.

  5. Enter an application Name.

  6. From Authentication methods, select Client secret basic.

  7. Click Define scopes.

  8. Select the Scopes.

  9. Click Create.

  10. Copy the Client ID.

  11. Copy the Client secret.

How to retrieve the pool ID

  1. Sign in to your Celonis account.

  2. Navigate to Data integrations.

  3. Click the required Data pool.

  4. From the URL, copy the pool ID. For example, if the URL is  https://celigo.us-1.celonis.cloud/data-pool/pool-abc123, then pool-abc123 is your pool ID.

How to retrieve the App key

  1. Sign in to your Celonis admin account.

  2. Navigate to Admin and settings > Applications.

  3. Click + Add new application.

  4. Select Application key.

  5. Enter a Key name.

  6. Click Save.

  7. Copy the App key.

How to configure scopes

  1. Click Scope.

  2. To access all of the scopes in the API, click the » button.

    – or – 

    Check the scopes you want to add and click the > button.

  3. Click Save.

Additional references