{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/celonis-apis/connecting-to-celonis-platform/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Connecting audit log, login history, and Studio adoption APIs to Celonis Platform

\n

In Admin & Settings you can view your audit log, team login history, and studio adoption statistics. However, these views are limited with standardized user interfaces. To run a more in-depth analysis of this data, connect to the respective APIs and then use a data extractor to feed this information back into the Celonis Platform. This lets you create your own views in Studio.

\n

To connect to the APIs and create an extractor, follow these procedures in order:

\n\n

Once the data is extracted, you can then create a data model using this data. You are then ready to go to Studio and create a view using the data from the API.

\n

Creating an application and granting it API permissions

\n

To start, create an OAuth client in your team and grant this client API permissions.

\n
    \n
  1. \nGo to \nAdmin & Settings\n and select \"Applications\".\n
    2. \n
  2. \nClick the \nAdd New Application\n button and then select \"OAuth client\" to create your OAuth client.\n
    3. \n
\n

\n \n \n

\n

When creating your OAuth client, use the following configurations:

\n\n

\n \n \n

\n
    \n
  1. \nClick \nCreate\n and then copy the \nclient ID\n and \nclient secret\n for later use.\n
    2. \n
  2. \nClick \nPermissions\n and then edit the \nTeam\n permissions.\n
    3. \n
\n

\n \n \n

\n
    \n
  1. \nAssign Audit Log API, Login History API, and Studio Adoption APIs permissions to your newly created application as required.\n
    2. \n
\n

\n \n \n

\n
    \n
  1. \nClick \nSave\n.\n
    2. \n
  2. \nThe OAuth client now has the relevant API permissions, but you also need to request an OAuth access token.\n

    Tip

    \n

    Alternatively, you can create an application key and assign the following permissions: Audit Log API, Login History API, and Studio Adoption APIs.

    \n

    For more information, see: Creating and granting permissions to application keys.

    \n
    3. \n
\n

Test OAuth credentials

\n

The created OAuth credentials can be best tested in Postman or via the command line tool curl (it is installed on most workstations or can be found in the machine learning workbench in Celonis).

\n

Follow the steps outlined here while using the required scope:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n    \"access-token\": \"randomizedAccessToken\",\n    \"scope\": \"scope1 scope2 scopeN\",\n    \"token_type\": \"Bearer\",\n    \"expires_in\": 899\n}
\n
\n

Migrating to OAuth 2.0

\n

If you already have an application or an extractor built that is calling one or all of these APIs and you want to migrate this application to take advantage of OAuth 2.0, see Migrating to OAuth 2.0.

","headings":[{"value":"Connecting audit log, login history, and Studio adoption APIs to Celonis Platform","depth":1},{"value":"Creating an application and granting it API permissions","depth":2},{"value":"Test OAuth credentials","depth":2},{"value":"Migrating to OAuth 2.0","depth":2}]},"contentItem":{"data":{"lastModified":"2025-05-22T17:57:31.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"fb16f608-8287-5528-8df8-ea366306bea3__redocly content/celonis-apis/connecting-to-celonis-platform/","seo":{"title":"Connecting audit log, login history, and Studio adoption APIs to Celonis Platform","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"celonis-apis/connecting-to-celonis-platform.md","pageBaseUrl":"/celonis-apis/connecting-to-celonis-platform","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Connecting audit log, login history, and Studio adoption APIs to Celonis Platform","id":"connecting-audit-log-login-history-and-studio-adoption-apis-to-celonis-platform"},{"depth":2,"value":"Creating an application and granting it API permissions","id":"creating-an-application-and-granting-it-api-permissions"},{"depth":2,"value":"Test OAuth credentials","id":"test-oauth-credentials"},{"depth":2,"value":"Migrating to OAuth 2.0","id":"migrating-to-oauth-20"}]},"data":{"title":""},"catalogInfo":null,"link":"/celonis-apis/connecting-to-celonis-platform/","sidebarName":"celonis","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}