# Adding Aurinko to Google Workspace allowlist

This setup is for new Aurinko users planning to trial the [Email API](https://docs.aurinko.io/unified-mailbox-api/email-api) using their Google Workspace accounts.

If you already have your Google-verified app you don't have to follow these instructions; simply enter your client id and secret in the Aurinko app settings:<br>

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2FxmiyeE9KvSrX8DsbczT5%2Fimage.png?alt=media&#x26;token=e95e5312-0ba2-457e-a44b-9d482e85b1e3" alt=""><figcaption></figcaption></figure></div>

For trials with the default Aurinko app id please follow the following steps:

1. **Login to the Admin Console of your Google Workspace**

You must be signed in as a [super administrator](https://support.google.com/a/answer/2405986#super_admin) of your Google Workspace to complete the actions listed below.

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2F66nfxIvk6s0iKpD3QlKw%2Fimage.png?alt=media&#x26;token=96d5127e-a4d6-45a8-ba2f-3453caa7ffd0" alt=""><figcaption></figcaption></figure></div>

2. **Navigate to the API controls in Security Settings**

From the Admin console home, go to **Security > API Controls**. This might be located at the bottom of the page.

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2F2yG1DQpHZULRdPk5OV3g%2Fimage.png?alt=media&#x26;token=706fbaea-5056-4d3e-91de-62a14303f817" alt=""><figcaption></figcaption></figure></div>

3. **Navigate to Manager Third-Party App Access**

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2FlEpc5xcoWrs9zAqLQPu9%2Fimage.png?alt=media&#x26;token=ad5622d3-92c6-4fde-b93c-b83e004e7353" alt=""><figcaption></figcaption></figure></div>

4. **Select "Add app" and "OAuth App Name Or Client ID" in the dropdown.**

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2F0BHbkbYtlKCOljZ7roHm%2Fimage.png?alt=media&#x26;token=94f08961-d589-4294-8f46-263c0707ce0a" alt=""><figcaption></figcaption></figure></div>

5. **Fill in the OAuth 2.0 Client ID for the Aurinko app:**

```
52020407124-5htuk1bfpsddj5k8eaa679kaa7vo0fm6.apps.googleusercontent.com
```

select the Aurinko app:

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2FSPuxELNuhYahVbyfvDQy%2Fimage.png?alt=media&#x26;token=6110faf0-3dd0-4a39-81c7-915db64422ac" alt=""><figcaption></figcaption></figure></div>

and the available OAuth client ID:

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2Fa3TN7P02q2p0gBo167So%2Fimage.png?alt=media&#x26;token=ad08cd1a-eeff-4a61-993f-8a83dbaadee1" alt=""><figcaption></figcaption></figure></div>

Then, select scope '**All users'**

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2F8LtWKQmLdqvAUk4MJTiA%2Fimage.png?alt=media&#x26;token=296e26db-25b4-46c2-8e17-6bbfbe140d32" alt=""><figcaption></figcaption></figure></div>

then, **"Trusted"** option for app access.

<div data-full-width="true"><figure><img src="https://3933352743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0ua36KLVlbUN5bA2bgiq%2Fuploads%2FlP4PYYfEk6VlICflEUNK%2Fimage.png?alt=media&#x26;token=cee3f5bb-82c5-4a27-a9f4-2b80ca1b4f0c" alt=""><figcaption></figcaption></figure></div>

**Confirm!**

**Now, you can start adding accounts of your Google Workspace domain in Aurinko.**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aurinko.io/getting-started/adding-aurinko-to-google-workspace-allowlist.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.