# 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.**
