Gmail Spoke

  • Release version: Washingtondc
  • Updated April 29, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Gmail Spoke

    The Gmail Spoke enables ServiceNow customers to integrate their ServiceNow instance with Google APIs for automating Gmail tasks. This integration requires an Integration Hub subscription and supports API version v1, with the latest spoke version being 1.3.2.

    Show full answer Show less

    Key Features

    • Sample Subflows: The spoke includes draft sample subflows for automating tasks, such as moving attachments from ServiceNow to Gmail.
    • Actions: It provides various actions for managing emails and labels, including:
      • Add, create, and remove labels from emails.
      • Add attachments from Gmail to ServiceNow records.
      • Send and reply to emails, and manage email deletion.
    • Account Requirements: Users must create a custom app in the Google Developers Console to utilize the spoke.
    • Connection Management: Integration Hub utilizes aliases for managing connection and credential information effectively across environments.
    • MID Server Support: Actions can run on an instance or via a MID Server, allowing for flexible configurations.

    Key Outcomes

    By implementing the Gmail Spoke, ServiceNow customers can streamline their email management processes, improve productivity through automation, and ensure a seamless integration experience with Google services. Proper setup and configuration allow for efficient task execution and management without repetitive credential updates.

    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.2 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.