--- 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 Google Calendar spoke # Set up the Google Calendar spoke {#ariaid-title1} Release version: Brazil Updated August 3, 2023 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read Set up an outbound integration between your ServiceNow instance and the Google Calendar Application Programming Interfaces (API) by setting up a connection and credential record. ## Before you begin * Request an Integration Hub subscription. * Activate the Google Calendar spoke. * Ensure that you have a Google Workspace account. * Ensure that you have a domain and an email address related with the domain. For example, www.mydomain.com and jane-admin@mydomain.com. Note: you can only register one email address per domain in Google Workspace. * Role required: admin. {#setup-gcal__ul_ts2_k3h_vhb} ## Create OAuth application on Google Calendar {#ariaid-title2} Create an OAuth application on the Google Calendar that authenticates requests to access the Google Calendar APIs from your ServiceNow instance. After successful authentication, you can generate an OAuth token that your ServiceNow can use to access the Google Calendar APIs. ### Before you begin Google Calendar spoke integration requirements: * A domain and an email address associated with the domain. For example, www.mydomain.com and jane-admin@mydomain.com. Note that you can only register one email address per domain in Google Workspace. * Google Workspace login credentials created with the same domain. {#configure-gcal-application__ul_nhk_cnh_gfb} Role required: admin. ### Procedure 1. Log in to with your Google Workspace credentials. 2. Create a project on Google Workspace. The project provides the OAuth application and the permissions to access the Google Calendar APIs from your ServiceNow instance. 1. Select the button. 2. On the Select a Project window, select NEW PROJECT. 3. In the Project name field, enter a unique name for the project. 4. In the Location field, select BROWSE to select an organization. 5. Select CREATE. The Notifications window confirms that the project is created. 6. Select SELECT PROJECT. {#configure-gcal-application__substeps_onr_5fh_5wb} 3. Enable the Google Calendar API permissions. 1. Select + ENABLE APIS AND SERVICES. 2. On the Welcome to the API Library page, navigate to the Google calendar API card under the Google Workspace heading. 3. Select Google Calendar API. 4. Select ENABLE. The Google calendar API is enabled on your project. {#configure-gcal-application__substeps_ulz_z3h_5wb} 4. Create the credentials that the connection and credential form will store. 1. Select CREATE CREDENTIALS. 2. Fill the form. {#configure-gcal-application__table_fx2_vlh_5wb__entry__2} | | | |-|-| | Select an API | Name of the API that your ServiceNow instance accesses. Note: Ensure that the Google Calendar API option is chosen. | | What data will you be accessing? \* | Type of data that your ServiceNow instance accesses from the Google Calendar application. Tip: To create an OAuth application, select User data. | [Table 1. Google Calendar API credentials] {#configure-gcal-application__table_fx2_vlh_5wb} 3. Select NEXT. 4. In the OAuth Consent Screen section, fill the form. {#configure-gcal-application__table_u4b_pnh_5wb__entry__3} | Field | Description | Mandatory? | |-|-|-| | App name | Custom name of the OAuth app. | Yes | | User support email | Users of the OAuth app can send their queries on consent to this email. | Yes | | App logo | Logo of the OAuth app, | No | | Developer contact information | Google uses this email ID to inform you about any changes to the project. | Yes | [Table 2. OAuth Consent Screen form] {#configure-gcal-application__table_u4b_pnh_5wb} 5. Select SAVE AND CONTINUE. {#configure-gcal-application__substeps_prs_flh_5wb} 5. **Optional:** Specify the permissions to access specific Google Calendar API. 1. Under the SCOPES heading, select ADD OR REMOVE SCOPES. 2. In the Update selected scopes window, enter Google Calendar in the Enter property name or value field. 3. From the list, select Google Calendar API. 4. Select the required APIs from the list. 5. Select UPDATE. {#configure-gcal-application__substeps_s1y_34g_wxb} 6. Generate the OAuth Client ID and related details. You must enter the OAuth Client ID and related details in the connection and credential form. 1. In the Application type field, select Web application. 2. In the Name field, enter a custom name for the application. 3. To add a redirect URL, under the Authorised redirect URIs heading, select + ADD URI. 4. Enter the URL of your ServiceNow instance. 5. Select CREATE. The credentials for the OAuth application are created, as shown in the image. {#configure-gcal-application__substeps_u1t_gqg_wxb} 7. Select DONE. {#configure-gcal-application__steps_tdj_yxk_rhb} ## Configure a connection for the Google Calendar spoke {#ariaid-title3} Configure a connection to your Google Calendar account. The Google Calendar spoke connection and credential aliases use these connections to perform actions in Google Calendar. ### Before you begin Role required: admin. ### About this task The connection and credential record includes the details that you had set up when you created the OAuth app. See [Create OAuth application on Google Calendar](https://www.servicenow.com/docs/DH6ohUKiiOMd8SoOMx2SSA#configure-gcal-application "Create an OAuth application on the Google Calendar that authenticates requests to access the Google Calendar APIs from your ServiceNow instance. After successful authentication, you can generate an OAuth token that your ServiceNow can use to access the Google Calendar APIs."). ### 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 Google Calendar and click View Details. * To configure the default connection and credential alias record that is shipped along with the Google Calendar spoke, click View Details. * To manage more than one Google Calendar spoke connection records, you should create a new child alias record by clicking 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."). {#create-credential-gcal__ul_rb41_w2e_pbc} 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-gcal__table_r1j_dby_hcc__entry__2} | Field | Value required | |-|-| | Connection Information || | Connection Name | Auto-generated name to identify the connection record. | | Connection URL | Auto-generated URL for the Google APIs website. | | API Version | Auto-generated input of the current API version. | | Credential Information || | OAuth Client ID | Client ID you created during the Google Calendar application registration. | | OAuth Client Secret | Key value you created during the Google Calendar application registration. | | OAuth Redirect URL | Redirect URL of your ServiceNow instance in this format: https://<instance-name>.service-now.com/oauth_redirect.do. | | OAuth Authorization URL | Authorization URL for your Google Calendar configuration. | | OAuth Token URL | Token URL for your Google Calendar configuration. | [ ] {#create-credential-gcal__table_r1j_dby_hcc} 6. Click Save and Get OAuth Token. {#create-credential-gcal__steps_ppg_zzx_hcc} ### Result The Google Calendar spoke is set up and integrated with the ServiceNow instance. *[\>]: and then