SurveyMonkey Spoke

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 6 minutes to read

    • Manage surveys, responses, collectors, and so on in the SurveyMonkey account from your ServiceNow instance.

    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.

    Spoke version

    SurveyMonkey spoke v2.0.6 is the latest version.

    Supported versions

    This spoke was built for SurveyMonkey API version v3, but may be compatible with later versions.

    Spoke requirements

    Admin access to SurveyMonkey API Developer Portal.

    Spoke dependencies

    If you’re having trouble installing the app, ensure that these dependent plugins are installed:
    • ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    • Complex Object (com.glide.cobject)
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • ServiceNow IntegrationHub Action Template - Data Stream (com.glide.hub.action_type.datastream)
    Note:
    Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.

    Spoke actions

    The SurveyMonkey spoke provides actions to automate SurveyMonkey tasks when events occurs in your ServiceNow instance. Available actions include:

    Category Action Description
    Collector Management Create Collector Creates a collector for the given survey. Public app users need access to the Create/Modify Collectors scope.
    Delete Collector Deletes the specified collector. Public app users need access to the Create/Modify Collectors scope.
    Get Collector Details Retrieves details of the specified collector. Public app users need access to the View Collectors scope.
    Look up Collectors Stream Retrieves details of collectors in the specified survey.
    Contact Management Add Contacts to Contact List Creates multiple contacts in a contact list. Public app users need access to the Create/Modify Contacts scope.
    Create Contact List Creates a contact list. Public app users need access to the Create/Modify Contacts scope.
    Delete Contact List Deletes the specified contact list. Public app users need access to the Create/Modify Contacts scope.
    Look up Contact Lists Retrieves all contact lists. Public app users need access to the View Contacts scope.
    Look up Contacts in Contact List Retrieves all contacts in a contact list. Public app users need access to the View Contacts scope.
    Update Contact List Modifies a contact list. Public app users need access to the Create/Modify Contacts scope.
    Folder Management Create Folder Creates a folder.
    Look up Folders Retrieves the available folders.
    Response Management Look up Survey Responses Retrieves a list of responses. Public app users need access to the View Responses scope.
    Look up Survey Trends Retrieves the answer counts within the specified time period. Public app users need access to the View Response Details scope.
    Survey and Question Management Create Question Creates a question on the survey page. Public app users need access to the Create/Modify Surveys scope.
    Create Survey Creates an empty survey. Public app users need access to the Create/Modify Surveys scope.
    Delete Question Deletes the specified question. Public app users need access to the Create/Modify Surveys scope.
    Delete Survey Deletes the specified survey. Public app users need access to the Create/Modify Surveys scope.
    Get Survey Details Retrieves a list of full responses, including answers to all questions. Public app users need access to the View Response Details scope.
    Look up Questions Retrieves all questions in the specified survey.
    Look up Survey Pages Retrieves details of the page. Public app users need access to the View Surveys scope.
    Look up Surveys Retrieves a list of surveys owned by or shared with the authenticated user. Public app users need access to the View Surveys scope.
    Update Question Updates details of the specified question. Public app users need access to the Create/Modify Surveys scope
    Update Survey Modifies title, nickname, or language of the specified survey. Public app users need access to the Create/Modify Surveys scope.
    Team Management Look up Team Activity Stream Retrieves activity data for the specified team.
    Look up Team Member Details Retrieves details of the specified team member.
    Look up Team Members Stream Retrieves details of all members in the specified team.
    Look up Teams Stream Retrieves details of all teams that the authenticated user account belongs to.
    User Management Get User Details Retrieves the current user’s account details including their plan. Public app users need access to the View Users scope.
    Note:
    This spoke has a Look up User action and Software Asset Management related actions only.

    Connection and credential alias requirements

    Integration Hub uses aliases to manage connection and credential information. 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 more information, see Connections and Credentials.

    For information about setting up the spoke, see Set up the SurveyMonkey spoke.

    Set up the SurveyMonkey spoke

    Integrate the ServiceNow instance and SurveyMonkey account by creating a custom OAuth application in SurveyMonkey API Developer Portal to authenticate ServiceNow requests.

    Before you begin

    Role required: admin

    Procedure

    1. Log in to SurveyMonkey API Developer Portal as an admin and add an app.
      1. In OAuth Redirect URL, enter the ServiceNow instance URL in this format: https://<instance-name>.service-now.com/oauth_redirect.do.
      2. Copy and record the values of Client ID and Secret.
      3. Provide these scopes for the app:
        • Create/Modify Surveys
        • Create/Modify Collectors
        • Create/Modify Responses
        • View Response Details
        • View Contacts
        • Create/Modify Webhooks
        • View Library Assets
        • View Surveys
        • View Collectors
        • View Responses
        • Create/Modify Contacts
        • View Users
        • View Webhook
        Note:
        If you provide any additional scopes, ensure that you add these scopes in the OAuth Entity Scopes tab of the default application registry available in your ServiceNow instance.
    2. Configure the default application registry.
      1. Navigate to System OAuth > Application Registry.
      2. Open the record, Survey Monkey.
      3. On the form, fill these values:
        Field Description
        Client ID Client ID of the app created in SurveyMonkey API Developer Portal.
        Client Secret Secret of the app created in SurveyMonkey API Developer Portal.
        Redirect URL ServiceNow instance URL in this format: https://<instance-name>.service-now.com/oauth_redirect.do. Replace <instance-name> with your instance name.
        Note:
        If you have provided additional scopes, create records for those scopes in the OAuth Entity Scopes tab.
    3. Create a credential record.
      1. Navigate to Connections & Credentials > Credentials.
      2. Click New.
        The system displays the message What type of Credentials would you like to create?.
      3. Select OAuth 2.0 Credentials.
      4. On the form, fill in the fields.
        Field Value required
        Name Name to uniquely identify the record. Enter SurveyMonkey Credentials.
        Active Option to actively use the credential record.
        OAuth Entity Profile OAuth profile you created when you registered the SurveyMonkey app as an OAuth provider. Select Survey Monkey default_profile.
        Applies to MID Servers that can use this credential. Select All MID Servers.
        Order Order to apply this credential. Enter 100.
      5. Right-click the form header and click Save.
    4. Create a connection record.
      1. Navigate to Connections & Credentials > Connection & Credential Aliases.
      2. Open for the record for SurveyMonkey.
      3. From the Connections tab, click New.
        The system displays a blank HTTP(s) Connection form.
      4. On the form, fill these values.
        Field Value required
        Name Name to uniquely identify the connection record. EnterSurveyMonkey Connection.
        Credential Credential record you created for Zoom. Select SurveyMonkey Credentials.
        Connection alias Alias record associated with this connection.
        Connection URL Base URL to connect to your SurveyMonkey account. Enter https://api.surveymonkey.net.
        Active Option to actively use the connection.
        Domain Domain that the action or activity runs in.
      5. Optional: In the Attributes tab, provide your SurveyMonkey API version if it is different than the default value of v3.
      6. Click Submit.
      The ServiceNow instance and SurveyMonkey account are integrated.