Gmail Spoke
Summarize
Summary of Gmail Spoke
The Gmail Spoke enables ServiceNow customers to integrate their ServiceNow instance with Google APIs for automating Gmail tasks. This functionality requires an Integration Hub subscription and involves setting up a custom app in the Google Developers Console.
Show less
Key Features
- Sample Subflows: The spoke includes draft state sample subflows that automate tasks, such as moving attachments from ServiceNow to Gmail. Users can customize these subflows by copying them to a new application scope.
- Actions: Various actions are available for automating Gmail tasks based on ServiceNow events, including:
- Add or remove labels from emails.
- Add attachments from emails to ServiceNow records.
- Send, reply to, delete, or undelete emails.
- Retrieve details of specified emails and labels.
- Connection Management: Integration Hub uses aliases for managing connection and credential information, simplifying the process across multiple environments.
- MID Server Support: The actions can run directly on the instance or through a MID Server, allowing for flexible configuration.
Key Outcomes
By utilizing the Gmail Spoke, ServiceNow customers can automate their Gmail tasks efficiently, improving workflow and communication processes. This integration not only streamlines email management but also enhances the overall functionality of ServiceNow in conjunction with Google services.
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 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.