---
sourceDocument: Australia Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/integrate-applications

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up the Gmail spoke

# Set up the Gmail spoke {#ariaid-title1}

Release version: Australia  
Updated August 3, 2023  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
Set up an outbound integration between the ServiceNow instance and the Google APIs.

## Before you begin

* Request an Integration Hub subscription.
* Install the Gmail spoke plugin on the ServiceNow instance.
* Role required: admin.
{#setup-gmail__ul_ts2_k3h_vhb}

## About this task

To establish an outbound integration, you must complete these steps.

* [Set up an OAuth 2.0 client ID](https://www.servicenow.com/docs/yO1EOJMIBwmWWDYxhY8HdA#configure-gmail-application "Create a custom OAuth application to enable OAuth 2.0 authentication of the ServiceNow by the Google APIs.")
* [Configure a connection for the Gmail spoke](https://www.servicenow.com/docs/yO1EOJMIBwmWWDYxhY8HdA#create-credential-gmail "Configure the Gmail connection record to establish a connection between the ServiceNow instance and the Google APIs.")
{#setup-gmail__ul_fj5_gs1_gxb}

## Set up an OAuth 2.0 client ID {#ariaid-title2}

Create a custom OAuth application to enable OAuth 2.0 authentication of the ServiceNow by the Google APIs.

### Before you begin

Google Tasks integration requirements:

* A domain and an email address associated with the domain. For example, www.mydomain.com and jane-admin@mydomain.com. You can only register one email address per domain in G Suite.
* A Google G Suite or Gmail login created with the domain.
{#configure-gmail-application__ul_nhk_cnh_gfb}

Role required: admin.

### Procedure

1. Navigate to <https://console.developers.google.com>, create a project with your G Suite administrator credentials, and open the project.
2. From the APIs \& Services menu, select OAuth consent screen.
3. Enter the application name, and specify the Authorized domain <kbd class="ph userinput">service-now.com</kbd>.
4. Click Save.
5. From the APIs \& Services menu, select Credentials, and select Create OAuth client ID from the Create credentials list.
6. Select the application type Web application.
7. Enter the following Authorized redirect URI: <kbd class="ph userinput">https://&lt;instance&gt;.service-now.com/oauth_redirect.do</kbd> and select Create.
8. Copy the Client ID and the Client Secret to a text file.

## Configure a connection for the Gmail spoke {#ariaid-title3}

Configure the Gmail connection record to establish a connection between the ServiceNow instance and the Google APIs.

### Before you begin

Role required: admin.

### About this task

The connection and credentials contain the details such as the client ID, client secret, and the redirect URL that the Google Workspace must authenticate the ServiceNow instance.

### Procedure

1. Navigate to AllProcess AutomationWorkflow Studio.
2. Select the Integrations tab.
3. Select the Connections tab.
4. In the Search all connections field, enter <kbd class="ph userinput">Gmail</kbd>.
5. Select View Details.  
6. Select Configure.  
7. Fill the form with the details given in the table.  
   {#create-credential-gmail__table_ebx_vjh_gxb__entry__2}

   | Field | Description |
   |-|-|
   | Connection Name | Name of the connection between the Google Workspace and the ServiceNow instance. Note: The default name is Gmail and it's read-only. However, you can provide custom names when you set up more connection and credential records after this record. |
   | Connection URL | Enter the URL <kbd class="ph userinput">https://www.googleapis.com</kbd> Note: Make sure that you don't include spaces before or after this URL. If there are spaces, the connection fails.. |
   | OAuth Entity Name | Name to identity the OAuth entity record. |
   | OAuth Client ID | The OAuth client ID generated when you created the OAuth client ID. |
   | OAuth Client Secret | The OAuth client secret generated when you created the OAuth client ID. |
   | OAuth Redirect URL | The OAuth redirect URL. It must be in the format: <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/oauth_redirect.do</kbd>. |
   [Table 1. Configure connection form]

   {#create-credential-gmail__table_ebx_vjh_gxb}
8. Select Configure and Get OAuth Token.  
   You must log into Gmail after the OAuth token is issued.
{#create-credential-gmail__steps_gwt_qhs_wjb}

*[\>]: and then