Skip to main content

Celonis Product Documentation

Gmail Connection [Extractor Builder]

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.