Skip to content
Last updated

Team APIs

The Team APIs allow querying of the data for a Celonis Platform team, such as the list of members assigned to the team or the login history for members of this team.

NOTE: ALL TEAM OPERATIONS ARE SCOPED TO A CELONIS PLATFORM TEAM.

Base URLs

The base URLs for the Team APIs are:

  • Members API: https://your-team.celonis.cloud/api/external/members
  • Login History API: https://your-team.celonis.cloud/api/external/authentication-events

Replace your-team with the name of your Celonis instance to access the Team APIs.

Use Cases

The Team APIs can be used to:

  • Connect external monitoring tools, such as SIEM tools, to capture and monitor platform login events.
  • Viewing and analyze your login history with an external tool to monitor team usage or identify potential security issues.
  • Query and export a list of all members currently assigned to a Celonis Platform team.

Authentication

This API supports multiple methods of authentication:

  • (preferred method) Via OAuth 2.0 token with a scope team.user-group-info or team.login-history, passed in an HTTP header like this: Authorization: Bearer TOKEN.
  • Via Application keys passed in an HTTP header like this: Authorization: AppKey APPLICATION_KEY.
  • Via API keys, passed in an HTTP header like this: Authorization: Bearer API_KEY.

See this help page for more information about OAuth 2.0.