Connecting to Gmail (extractor)
Limited Availability
This extractor is currently in limited availability mode and can be added to your Celonis Platform environment by request only.
To request access to this extractor, please create a support ticket on Celopeers.
Important
This extractor's use and transfer to any other app of information received from Google APIs adheres to Google API Services User Data Policy including the Limited Use requirements.
Our Gmail extractor is based on the Gmail REST API and enables you to extract data from your Gmail account and use it in the Celonis Platform.
For further information about Gmail's REST API, see: Google Workspace - Gmail API Overview.
The Gmail REST API uses the OAuth2 authentication method. You can either ‘Use Celonis Client to Connect’, in which case you only need to authenticate with Google with a user account, or you can provide a client ID and client secret via the Google Cloud Management Console.
If you would like to provide a client ID and client secret, follow the prerequisites below:
The Gmail REST API uses the OAuth2 authentication method, requiring you to provide a username, password, client ID, and client secret. These authentication credentials can be created and configured via your Google Cloud Management Console, available to anyone with a Google account (including individual users).
To configure your authentication method:
Create a Google Cloud project for the connection with the Celonis Platform, see: Google Workspace - Create a Google Cloud project.
Enable the Gmail API for the project created in step 1, see: Google Workspace - Enable Google Workspace APIs.
Configure the OAuth consent, see: Google Workspace - Configure the OAuth consent screen and choose scopes.
Create access credentials, see: Google Workspace - Create access credentials.
When prompted to enter a redirect URL, use the following:
https://auth.redirect.celonis.cloud/extractor_redirect
Copy the client ID and client secret displayed with your access credentials:
For further information about Gmail's REST API, see: Google Workspace - Gmail API Overview.
With access to the necessary Gmail user permissions, you can create a connection between your Gmail account and the Celonis Platform from your data pool diagram:
Click Data Connections.
Click Add Data Connection and select Connect to Data Source.
Select Cloud - Gmail.
Enter the following connection details:
Name: Enter an internal reference for this data connection.
API URL: https://gmail.googleapis.com
Email: Enter your gmail address.
Use Celonis Client to Connect: Enter your username and password, alternatively, provide the client ID and client secret configured in your prerequisites.
Client ID: Taken from the Google Cloud Management Console steps.
Client Secret: Taken from the Google Cloud Management Console steps.
Advanced Settings: Leave as default.
Click Save.
If configured correctly, the Google sign in page should load. Select the account you want to use and, when prompted, click Continue to trust the Celonis Platform.
The connection between your Gmail account and the Celonis Platform is set.
