---
title: Google Workspace Admin
slug: google-g-suite
image: https://make-cxp-documentation.ams3.digitaloceanspaces.com/apps-center-icons/PREVIEW_google-g-suite.png
createdAt: 2025-02-03T13:29:04.395Z
---

With the Google Workspace Admin modules in Make, you can watch, list, create, update, retrieve, and delete users, roles, role assignments, and organizational units.

To get started with Google Workspace Admin, create an account at [https://workspace.google.com](https://workspace.google.com/intl/en_in/).

:::hint{type="info"}
Make's use and transfer of information received from Google APIs to any other app will adhere to [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy).
:::

## Connect Google Workspace Admin to Make

1. Log in to your Make account, add a Google Workspace Admin module to your Make, and click **Create a connection**.
2. Optional: In the **Connection name** field, enter a name for the connection.
3. Optional: Click **Show Advanced Settings** field, and enter the client credentials from your custom application. See [Connecting to Google services using Oauth2](#).
4. Click the **Sign in with Google** button and select your Google account.
5. Review the access information and click **Allow**.

You have successfully established the connection. You can now begin editing scenarios and adding more Google Workspace Admin modules. If your connection needs reauthorization at any point, follow the connection renewal steps [here](https://www.make.com/en/help/connections/connecting-to-services.html).

## Connecting to Google services using Oauth2

Make's modules' advanced settings let you enter your own OAuth2 client credentials. OAuth is a security authorization protocol to interact with your protected data that does not require sending your login information.

In order to use OAuth2 with your Google apps, you need to create your own project and a custom OAuth client in Google Cloud Console. This is useful for connecting restricted Google services, like Google Drive or Gmail, to Make.

The following procedure is intended for:

- **Personal use** (*@gmail.com* and *@googlemail.com* users)
- **Organizational use** (Internal use within a business or other organization*Google Workspace (formerly GSuite)* users that prefer to use a custom OAuth client)

Prerequisites:

- a Google account

To create a custom OAuth client for Google service you must do the following:

- [Create a project](#) on the Google Cloud Platform.
- [Enable APIs](docId:59gQZq_b0W2qglgGz1H89) on the Google Cloud Platform.
- [Configure your OAuth Consent Form](docId:59gQZq_b0W2qglgGz1H89) on the Google Cloud Platform.
- [Create credentials](docId:59gQZq_b0W2qglgGz1H89) on the Google Cloud Platform.
- [Enter your credentials](docId:59gQZq_b0W2qglgGz1H89) on Make.

### Create a project

1. Sign in to [Google Cloud Platform](https://console.developers.google.com/) using your Google credentials.
2. Open the [Dashboard](https://console.cloud.google.com/apis/dashboard), and click the *CREATE PROJECT* button.

   ![googleOAuthCreateProject.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/mrIBvNX--CZXKrK1JsxP1_uuid-93ed45bc-5cf7-12fa-a7fb-f4c6e565a88a.png "googleOAuthCreateProject.png")
3. Choose a name for your project, then click **Create**.

   ![googleOAuth2NameProject.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/f6b0E-RL67uy4_yTZUaEf_uuid-d8ae93ba-3392-bc31-2630-e9650850967d.png "googleOAuth2NameProject.png")

### Enable API

1. Click **Enable APIs and services**.

   ![googleOAuth2EnableAPIs.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/xWoXTeNPA5YLcu-xr0ybl_uuid-18d33770-2de7-682d-db1c-89c57052e2cb.png "googleOAuth2EnableAPIs.png")
2. Enter the name of the service you want to use (for example, Gmail API or Google Drive API) in the **Enable APIs and services** field.
3. The desired service option should display as you type. Click on the API/service you want to connect to Make.

   ![googleOAuth2SearchAPIs.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/b2dL2-DEPStpfRrucBNvO_uuid-9987ee2e-5ff6-b584-5c7a-b8af43db32ec.png "googleOAuth2SearchAPIs.png")
4. Click **Enable**.

   ![googleOAuth2ClickEnable.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/qcyZQCVoQnmZzeGstMBpN_uuid-62cff83b-f19e-f06c-c3a2-79eaf2b3ccc7.png "googleOAuth2ClickEnable.png")

### Configure your OAuth Consent Form

1. Go to *APIs & Services* > *[OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent)* settings, choose the **External** option, then click **Create**.

   ![googleOAuth2CreateConsentScreen.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/QzolwfWIx_WRGMWe1hkGV_uuid-595b53cf-ebfb-fba9-d5d3-044074b30426.png "googleOAuth2CreateConsentScreen.png")
2. Fill in the required fields as follows:
3. **For the *Scopes* section:**
4. On the Test Users section, click **Add users** to add the email address associated with the Google account you want to connect to Make.

For example: `Make`.

Enter the name of the app asking for consent.

`make.com`

`integromat.com`

SERVICE/API  	  REQUIRED SCOPES     \<app>  	                                  \<scopes>                                   \<app>  	                                  \<scope>

Add required scopes for the Google service you want to connect to Make.

### Create credentials

1. Open the *[Credentials](https://console.cloud.google.com/apis/credentials)* settings page.
2. Click **+ Create credentials**, and select the **OAuth client ID** option.

   ![googleOAuth2CreateCredentials.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/WCES99MXe8lr7UmC_bT3X_uuid-c62d2f70-61b0-5146-19d9-7ad14c1f732b.png "googleOAuth2CreateCredentials.png")
3. Fill in the required fields as follows, then click **Create**.

   ![googleOAuth2EnterClientInfo.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/CbpuRrJw_WqjxxyZvc6Jz_uuid-1a50cf68-1ab4-8e4f-8950-f7d715189dd4.png "googleOAuth2EnterClientInfo.png")
4. A dialog containing the app's *Client ID* and *Client Secret* is displayed.

   ![googleOAuth2ClientCreated.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/J_cAT4T6h48oSduQbWvSh_uuid-03f96d5d-e805-f68c-7107-ed3036d10d72.png "googleOAuth2ClientCreated.png")

:::hint{type="success"}
### OAuth redirect URI domain

Notice that the redirect URI starts with `https://www.integromat.com` instead of `https://www.make.com`. This is currently a known issue in Make.

Make was formerly called Integromat, which means you can trust this URL as much as any Make URL.
:::

- https\://www\.integromat.com/oauth/cb/google-restricted for Gmail or Google Drive
- https\://www\.integromat.com/oauth/cb/google/ for other Google apps
- https\://www\.integromat.com/oauth/cb/google-custom for Google Text-to-Speech and Google Natural Language
- https\://www\.integromat.com/oauth/cb/app for any app created via the Make Developer Platform

Add **one** of the following URIs:

### Enter your credentials

1. Go to your **Make** Make and choose the Google module you want to use.
2. Next to **Connection**, click **Add**.
3. Click **Show advanced settings**.
4. Enter the **Client ID** and **Client Secret** you retrieved in [step 4 of the preceding procedure](#) into the respective fields, then click **Continue**.Create credentials
5. Sign in with your Google account.
6. The *This app isn't verified* window appears.
7. Click on **Continue**.

   ![googleOAuth2GoogleHasntVerified.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/3UbYnalfIY0EgfPe_k5CN_uuid-4229a9d2-5881-4739-4c4b-fad99bf928f8.png "googleOAuth2GoogleHasntVerified.png")
8. Click the check box next to Google Product and click **Allow** to confirm your choices.

You have now established the connection to your chosen Google service using a custom OAuth client.

## User

Using the following modules, you can watch, create, update, list, retrieve, and delete users and make users super admin.

### [Watch Users](#)

Triggers when a new user is created.

| &#x20;                |                                                                                 |
| --------------------- | ------------------------------------------------------------------------------- |
| **Connection**        | [Establish a connection to your G Suite Admin account](#).                      |
| **Your Domain**       | Select the domain whose users you want to watch.                                |
| **Query Search**      |                                                                                 |
| **Projection**        |                                                                                 |
| **Custom Field Mask** | Enter a comma-separated list of schema names.                                   |
| **Limit**             | The maximum number of users Make should return during one Make execution cycle. |

For more details, refer to the [Search Query Documentation](https://developers.google.com/admin-sdk/directory/v1/guides/search-users).

- **Field**: Specifies the user attribute to search. For example, `givenName`.
- **Operator**: Test is performed on this attribute. For example, `contains a value`.
- **Value**: Specifies the content to test. For example, `Andrew`.

Enter the search query. You can search the users with the following three attributes:

- `Basic`: Do not include any custom fields for the user.
- `Custom`: Include custom fields from schemas requested in customFieldMask.
- `Full`: Include all fields associated with this user.

Select the subset to fetch the user details:

### [List Users](#)

Retrieves a list of users in a domain.

| &#x20;                |                                                                                 |
| --------------------- | ------------------------------------------------------------------------------- |
| **Connection**        | [Establish a connection to your G Suite Admin account](#).                      |
| **Your Domain**       | Select the domain whose users you want to list.                                 |
| **Query Search**      |                                                                                 |
| **Order By**          |                                                                                 |
| **Projection**        |                                                                                 |
| **Custom Field Mask** | Enter a comma-separated list of schema names.                                   |
| **Show Deleted**      | When selected, lists the users who are deleted.                                 |
| **Sort Oder**         |                                                                                 |
| **View Type**         |                                                                                 |
| **Limit**             | The maximum number of users Make should return during one Make execution cycle. |

For more details, refer to the [Search Query Documentation](https://developers.google.com/admin-sdk/directory/v1/guides/search-users).

- **Field**: Specifies the user attribute to search. For example, `givenName`.
- **Operator**: Test is performed on this attribute. For example, `contains a value.`.
- **Value**: Specifies the content to test. For example, `Andrew`.

Enter the search query. You can search the users with the following three attributes:

- *Email*
- *Family Name*
- *Given Name*

Select the order in which you want to list the users:

- `Basic`: Do not include any custom fields for the user.
- `Custom`: Include custom fields from schemas requested in customFieldMask.
- `Full`: Include all fields associated with this user.

Select the subset to fetch the user details:

- *Ascending*
- *Descending*

Select the order in which you list the users:

- *Admin View*
- *Domain View*

Select the option to view the users:

### [Get a User](#)

Gets the details of a user.

| &#x20;                |                                                            |
| --------------------- | ---------------------------------------------------------- |
| **Connection**        | [Establish a connection to your G Suite Admin account](#). |
| **User ID**           | Select the User ID whose details you want to retrieve.     |
| **Projection**        |                                                            |
| **Custom Field Mask** | Enter a comma-separated list of schema names.              |
| **View Type**         |                                                            |

- `Basic`: Do not include any custom fields for the user.
- `Custom`: Include custom fields from schemas requested in customFieldMask.
- `Full`: Include all fields associated with this user.

Select the subset to fetch the user details:

- *Admin View*
- *Domain View*

Select the view:

### [Create a User](#)

Creates a new user.

| &#x20;                            |                                                                                          |
| --------------------------------- | ---------------------------------------------------------------------------------------- |
| **Connection**                    | [Establish a connection to your G Suite Admin account](#).                               |
| **First Name**                    | Enter the first name of the user.                                                        |
| **Last Name**                     | Enter the last name of the user.                                                         |
| **Password**                      | Enter the password of the user.                                                          |
| **Your Domain**                   | Select the domain for the user.                                                          |
| **Phones**                        |                                                                                          |
| **Secondary Email**               |                                                                                          |
| **Change Password at Next Login** | When selected, it prompts the user to change the password when tried to login next time. |

- *Yes*
- *No*
- *Not defined*

Select whether this is the primary phone number of the user:

**Primary**

Select the phone number type.

**Type**

Enter the phone number.

**Phone Number**

Add the phone numbers of the user:

- *Home*
- *Work*
- *Other*

Select the email address type:

**Type**

Enter the email address.

**Email Address**

Add the secondary email address:

### [Update a User](#)

Updates an existing user.

| &#x20;              |                                                            |
| ------------------- | ---------------------------------------------------------- |
| **Connection**      | [Establish a connection to your G Suite Admin account](#). |
| **User ID**         | Select the User ID you want to update.                     |
| **First Name**      | Enter the first name of the user.                          |
| **Last Name**       | Enter the last name of the user.                           |
| **Password**        | Enter the password of the user.                            |
| **Your Domain**     | Select the domain for the user.                            |
| **Phones**          |                                                            |
| **Secondary Email** |                                                            |

- *Yes*
- *No*
- *Not defined*

Select whether this is the primary phone number of the user:

**Primary**

Select the phone number type.

**Type**

Enter the phone number.

**Phone Number**

Add the phone numbers of the user:

- *Home*
- *Work*
- *Other*

Select the email address type:

**Type**

Enter the email address.

**Email Address**

Add the secondary email address:

### [Delete a User](#)

Deletes a user.

| &#x20;         |                                                            |
| -------------- | ---------------------------------------------------------- |
| **Connection** | [Establish a connection to your G Suite Admin account](#). |
| **User ID**    | Select the User ID of the user you want to delete.         |

### [Make a User a Super Admin](#)

Makes a user a super administrator.

| &#x20;         |                                                             |
| -------------- | ----------------------------------------------------------- |
| **Connection** | [Establish a connection to your G Suite Admin account](#).  |
| **User ID**    | Select the User ID of the user whom you make a super admin. |

## Organizational Unit

Using the following modules, you can list, retrieve, create, update, and delete organizational units.

### [List Organizational Units](#)

Retrieves a list of all organizational units for an account.

| &#x20;         |                                                                                                |
| -------------- | ---------------------------------------------------------------------------------------------- |
| **Connection** | [Establish a connection to your Google Workspace Admin account](#).                            |
| **Path**       | Select the path whose organizational units you want to list.                                   |
| **Type**       |                                                                                                |
| **Limit**      | The maximum number of organizational units Make should return during one Make execution cycle. |

- *All*
- *Children*

Select the type of organizational units you want to list:

### [Get an Organizational Unit](#)

Gets the details of an organizational unit.

| &#x20;                       |                                                                                        |
| ---------------------------- | -------------------------------------------------------------------------------------- |
| **Connection**               | [Establish a connection to your Google Workspace Admin account](#).                    |
| **Get Organizational Unit**  |                                                                                        |
| **Organizational Unit Path** | Select the organizational path whose organizational unit details you want to retrieve. |

- *By Path*
- *By ID*

Select the method by which you want to retrieve the organizational units:

### [Create an Organizational Unit](#)

Creates a new organizational unit.

| &#x20;                              |                                                                                                                  |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Connection**                      | [Establish a connection to your Google Workspace Admin account](#).                                              |
| **Name**                            | Enter the name of the organizational unit.                                                                       |
| **Description**                     | Enter the details of the organizational unit.                                                                    |
| **Parent Organizational Unit Path** | Enter the path to the parent organizational unit if this organization is a subsidiary of any other organization. |

### [Update an Organizational Unit](#)

Updates an existing organizational unit.

| &#x20;                       |                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------ |
| **Connection**               | [Establish a connection to your Google Workspace Admin account](#).                  |
| **Get Organizational Path**  |                                                                                      |
| **Organizational Unit Path** | Select the organizational path whose organizational unit details you want to update. |
| **Name**                     | Enter a new name for the organizational unit.                                        |
| **Description**              | Enter the details of the organizational unit.                                        |

- *By Path*
- *By ID*

Select the method by which you want to retrieve the organizational units:

### [Delete an Organizational Unit](#)

Deletes an organizational unit.

| &#x20;                       |                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------ |
| **Connection**               | [Establish a connection to your Google Workspace Admin account](#).                  |
| **Get Organizational Path**  |                                                                                      |
| **Organizational Unit Path** | Select the organizational path whose organizational unit details you want to delete. |

- *By Path*
- *By ID*

Select the method by which you want to retrieve the organizational units:

## Role

Using the following modules, you can create, update, list, retrieve, and delete roles.

### [List Roles](#)

Retrieves a list of all roles in a domain.

| &#x20;         |                                                                                 |
| -------------- | ------------------------------------------------------------------------------- |
| **Connection** | [Establish a connection to your G Suite Admin account](#).                      |
| **Limit**      | The maximum number of roles Make should return during one Make execution cycle. |

### [Get a Role](#)

Gets the details of a role.

| &#x20;         |                                                            |
| -------------- | ---------------------------------------------------------- |
| **Connection** | [Establish a connection to your G Suite Admin account](#). |
| **Role ID**    | Select the Role ID whose details you want to retrieve.     |

### [Create a Role](#)

Creates a new role.

| &#x20;               |                                                            |
| -------------------- | ---------------------------------------------------------- |
| **Connection**       | [Establish a connection to your G Suite Admin account](#). |
| **Role Name**        | Enter a name for the role.                                 |
| **Role Privileges**  |                                                            |
| **Role Description** | Enter the details of the role.                             |

Select the permission.

**Privilege Name**

Select the service.

**Service ID**

Add the permissions for the role:

### [Update a Role](#)

Updates an existing role.

| &#x20;               |                                                            |
| -------------------- | ---------------------------------------------------------- |
| **Connection**       | [Establish a connection to your G Suite Admin account](#). |
| **Role ID**          | Select the Role ID you want to update.                     |
| **Role Name**        | Enter a name for the role.                                 |
| **Role Privileges**  |                                                            |
| **Role Description** | Enter the details of the role.                             |

Select the permission.

**Privilege Name**

Select the service.

**Service ID**

Add the permissions for the role:

### [Delete a Role](#)

Deletes a role.

| &#x20;         |                                                            |
| -------------- | ---------------------------------------------------------- |
| **Connection** | [Establish a connection to your G Suite Admin account](#). |
| **Role ID**    | Select the Role ID you want to delete.                     |

## Role Assignment

Using the following modules, you can list, retrieve, assign, and delete role assignments.

### [List Role Assignments](#)

Retrieves a list of all role assignments.

| &#x20;                      |                                                                                            |
| --------------------------- | ------------------------------------------------------------------------------------------ |
| **Connection**              | [Establish a connection to your G Suite Admin account](#).                                 |
| **Search Role Assignments** |                                                                                            |
| **Your Domain**             | Select the domain whose role assignments you want to list.                                 |
| **Limit**                   | The maximum number of role assignments Make should return during one Make execution cycle. |

- *By User Email Name*
- *By User ID*
- *By Role ID*

Select the option to search the role assignments you want to list:

### [Get a Role Assignment](#)

Gets the details of a role assignment.

| &#x20;                 |                                                                   |
| ---------------------- | ----------------------------------------------------------------- |
| **Connection**         | [Establish a connection to your G Suite Admin account](#).        |
| **Role Assignment ID** | Select the Role Assignment ID whose details you want to retrieve. |

### [Assign a User to a Role](#)

Assigns a user to a specific role.

| &#x20;         |                                                            |
| -------------- | ---------------------------------------------------------- |
| **Connection** | [Establish a connection to your G Suite Admin account](#). |
| **Role ID**    | Select the Role ID which you want to assign to the user.   |
| **Assign To**  | Select the user to whom you want to assign the role.       |

### [Delete a Role Assignment](#)

Deletes a role assignment.

| &#x20;                 |                                                            |
| ---------------------- | ---------------------------------------------------------- |
| **Connection**         | [Establish a connection to your G Suite Admin account](#). |
| **Role Assignment ID** | Select the Role Assignment ID you want to delete.          |

## Other

### [List Privileges](#)

Retrieves a list of all privileges for a customer.

| &#x20;         |                                                                                      |
| -------------- | ------------------------------------------------------------------------------------ |
| **Connection** | [Establish a connection to your G Suite Admin account](#).                           |
| **Limit**      | The maximum number of privileges Make should return during one Make execution cycle. |

### [Make an API Call](#)

Performs an arbitrary authorized API call.

| &#x20;           |                                                                                                              |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| **Connection**   | [Establish a connection to your G Suite Admin account](#).                                                   |
| **URL**          |                                                                                                              |
| **Method**       |                                                                                                              |
| **Headers**      | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
| **Query String** | Enter the request query string.                                                                              |
| **Body**         | Enter the body content for your API call.                                                                    |

:::hint{type="success"}
### Note

For the list of available endpoints, refer to the [G Suite Admin API Documentation:](https://developers.google.com/admin-sdk)

- [Directory API](https://developers.google.com/admin-sdk/directory/v1/reference)
- [Enterprise License Manager API](https://developers.google.com/admin-sdk/licensing/v1/reference)
- [Reports API](https://developers.google.com/admin-sdk/reports/v1/reference)
- [G Suite Reseller API](https://developers.google.com/admin-sdk/reseller/v1/reference)
- [Groups Settings API](https://developers.google.com/admin-sdk/groups-settings/v1/reference)
- [Groups Migration API](https://developers.google.com/admin-sdk/groups-migration/v1/reference)
- [Data Transfer API](https://developers.google.com/admin-sdk/data-transfer/v1/reference)
:::

Enter a path relative to `https://www.googleapis.com`. For example: `/admin/directory/v1/users`

to delete an entry.

**DELETE**

to make a partial entry update.

**PATCH**

to update/replace an existing entry.

**PUT**

to create a new entry.

**POST**

to retrieve information for an entr&#x79;**.**

**GET**

Select the HTTP method you want to use:

### [Example of Use - List Users in a Domain](#)

The following API call returns all the users in the same domain from your G Suite Admin account:

**URL**:

`/admin/directory/v1/users`

**Method**:

`GET`

**Query String**: **Key**: `domain` **Value**: `{{domain you want to retrieve users from}}`

![61f26e2f89538.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/VOwmJeKcj-cBRWD_5INmR_uuid-51e1660e-4585-3736-04d2-79249cf621ce.png "61f26e2f89538.png")

Matches of the search can be found in the module's **Output** under *Bundle* > *Body > users.&#x20;*&#x49;n our example, 3 users were returned:

![61f26e307dc54.png](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/F4gF4hn7er1CWDIYSslc3_uuid-4a088017-20cc-5286-171b-347c35ec77c9.png "61f26e307dc54.png")