Skip to main content

Celonis Product Documentation

Gmail Connection [Extractor Builder]

Important

Any references to third-party products or services do not constitute Celonis Product Documentation nor do they create any contractual obligations. This material is for informational purposes only and is subject to change without notice.

Celonis does not warrant the availability, accuracy, reliability, completeness, or usefulness of any information regarding the subject of third-party services or systems.

The Gmail Extractor is based on the Extractor Builder. You can use the default Extractor provided by Celonis or use the Extractor Builder to customize the Extractor further, based on your needs.

Authentication and permissions

The Gmail API uses OAuth2 Authentication. To connect with OAuth2, you need to provide a client ID and client secret.

Follow these steps in your Google Workspace to set-up a connection:

  1. Create a Google Cloud project

  2. Enable the Gmail APIs for this project

  3. Configure the OAuth consent

  4. Create access credentials

    1. redirect URI: https://auth.redirect.celonis.cloud/extractor_redirect

  5. Create a Gmail Connection in Celonis by adding the credentials.

Endpoints

The default Extractor allows you to call these endpoints:

Method

Endpoint

Description

GET

Calendar List

Retrieve data about the calendar

GET

  • Events

Retrieve data about events in the calendar

GET

Settings

Retrieve data about settings

API request limits and details

Visit the Gmail API documentation.