> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/value-stream-modeller/settings-and-configuration/admin/integration-celonis.md).

# Integration with Celonis

VSM can gather data retrieved from Celonis and use value streams to improve business processes. Data retrieved from Celonis can be used as triggers and inputs in your value streams, and process outcomes can be sent back to Celonis for further analysis.

To configure the connection with Celonis, you need the environment URL and Celonis token.

## Environment URL

You can get the URL from the [Celonis EMS](https://www.celonis.com/ems/platform/) application.

{% hint style="warning" %}
If you don't have the environment URL, contact the Celonis support team.
{% endhint %}

{% stepper %}
{% step %}

#### Copy the environment URL

Copy the URL from your Celonis account.
{% endstep %}

{% step %}

#### Open VSM Admin

In VSM, go to **Admin**.
{% endstep %}

{% step %}

#### Configure the Celonis datasource

Open the **Datasources** tab, select **Celonis** as the datasource type, and paste the URL in the **Environment** field.
{% endstep %}

{% step %}

#### Save your changes

{% endstep %}
{% endstepper %}

## Token

{% stepper %}
{% step %}

#### Create an Application Key in Celonis

In your Celonis account, go to **Admin & Settings** -> **Applications** and choose **Add New Application** -> **Application Key**.
{% endstep %}

{% step %}

#### Name the key

Enter the key name to be able to identify the key in future.
{% endstep %}

{% step %}

#### Copy the token

Be sure to save the token safely, as it will not be displayed again.
{% endstep %}

{% step %}

#### Open VSM Admin

In VSM, go to **Admin**.
{% endstep %}

{% step %}

#### Paste the token

Open the **Datasources** tab, select **Celonis** as the datasource type, and paste the token in the **Token** field.
{% endstep %}

{% step %}

#### Save your changes

{% endstep %}
{% endstepper %}

<figure><img src="/files/oFgX1p6mdwruJhxeCy2S" alt="VSM Admin Datasources tab with Celonis configuration"><figcaption><p>The Datasources tab where you configure the Celonis environment URL and token</p></figcaption></figure>

After configuring the URL and token, you can configure the data flow between VSM and Celonis. See the [Data Flow between VSM and Celonis](/value-stream-modeller/value-stream-designer/celonis-data-flow.md) documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.emporix.io/value-stream-modeller/settings-and-configuration/admin/integration-celonis.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.