Gmail Spoke
Summarize
Summary of Gmail Spoke
The Gmail Spoke enables integration between your ServiceNow instance and Google APIs, facilitating automation of Gmail tasks. This spoke requires an Integration Hub subscription and is compatible with API version v1, with the latest spoke version being 1.3.3.
Show less
Key Features
- Subflows: The spoke includes sample subflows in draft form for automating tasks, such as moving attachments from ServiceNow to Gmail, which can be customized by copying them to a new application scope.
- Actions: Various actions automate Gmail tasks triggered by events in ServiceNow, including:
- Add Label to Email
- Create New Label
- Remove Label From Email
- Add Attachment To ServiceNow Record
- Send Email
- Delete Email
- Look Up Emails
- Account Requirements: A custom app must be created in the Google Developers Console to use the Gmail Spoke.
- Connection and Credential Management: Integration Hub uses aliases for efficient management of connection and credential information, simplifying configuration across multiple environments.
- MID Server Support: Actions can run on the instance or through a MID Server, with the ability to configure where actions are executed based on the Gmail alias connection record.
Key Outcomes
By leveraging the Gmail Spoke, ServiceNow customers can streamline email management tasks, automate workflows involving Gmail, and enhance productivity through seamless integration with Google services. Setting up the spoke allows for efficient handling of emails and attachments directly within ServiceNow workflows.
Set up an outbound integration between the ServiceNow instance and the Google APIs.
Request apps on the Store
Visit the ServiceNow Store website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.
Integration Hub subscription
This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.
Supported versions
API version v1.
Spoke version
Gmail spoke v1.3.3 is the latest version.
Spoke subflows
The Gmail spoke provides sample subflows in the draft state to demonstrate automating Gmail tasks. To customize a sample subflow, copy it to a new application scope. Available sample subflows include:
| Subflow | Description |
|---|---|
| Move a ServiceNow attachment to Gmail | Copies an attachment from ServiceNow to Gmail. |
Spoke actions
The Gmail spoke provides actions to automate Gmail tasks when events occur in ServiceNow. Available actions include:
| Category | Action | Description |
|---|---|---|
| Label Management | Add Label to Email | Add a label to an email. |
| Create New Label | Create a label in your Gmail account. | |
| Lookup Label ID By Name | Retrieve details of a specified Label ID. | |
| Remove Label From Email | Remove the specified label from an email. | |
| Email Management | Add Attachment To ServiceNow Record | Add an attachment from an email in your Gmail account to a ServiceNow record. |
| Get Email Details | Retrieve details of a specified email. | |
| Look Up Emails | Retrieve details of specified emails. | |
| Reply To Email | Send a reply to an email. | |
| Send Email | Send email from your Gmail account to specified recipients. | |
| Delete Email | Delete the specified email. | |
| Undelete Email | Retrieve the specified email from the Bin. |
Gmail spoke account requirements
The Gmail spoke requires a custom app that you create in the Google Developers Console.
Connection and credential alias requirements
Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.
For information about setting up the spoke, see Set up the Gmail spoke.
MID Server requirements
These actions use REST calls that can run either on an instance or, optionally, through a MID Server. Use the connection record associated with the Gmail alias to configure where actions run and, if needed, specify MID Server selection attributes. For more information, see MID server.
To set up the MID Server for this spoke, see Set up MID Server for a spoke.