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

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up the Gmail spoke

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

Release version: Brazil  
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/dukFLXLiBZ7XbANw5gGegA#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/dukFLXLiBZ7XbANw5gGegA#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. Click the Integrations tab.
3. Under Connections, toggle and enable the Outbound connections.
4. Locate the alias for Gmail and click View Details.  

   To manage more than one Gmail connection record, create a new child alias record by selecting Add Connection. For more information about using multiple connections, see [Supporting multiple connections](https://www.servicenow.com/docs/D9pGgVwvfvFrzWX3lknyWg "Support several connections to a single integration provider. Select connections for flows, subflows, and actions directly from a flow.").

   If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.

5. On the form, fill in these fields:  
   {#create-credential-gmail__table_ebx_vjh_gxb__entry__2}

   | Field | Description |
   |-|-|
   | Connection Information ||
   | 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.. |
   | Credential Information ||
   | 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>. |
   [ ]

   {#create-credential-gmail__table_ebx_vjh_gxb}
6. Click Save and Get OAuth Token.  
   You must log into Gmail after the OAuth token is issued.
{#create-credential-gmail__steps_gwt_qhs_wjb}

*[\>]: and then