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.
Avant de commencer
- Request an Integration Hub subscription.
- Activate the SurveyMonkey spoke.
- Role required: admin.
Procédure
-
Log in to SurveyMonkey API Developer Portal as an admin and add an app.
- In OAuth Redirect URL, enter the ServiceNow instance URL in this format: https://<instance-name>.service-now.com/oauth_redirect.do.
- Copy and record the values of Client ID and Secret.
-
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
Remarque :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.
-
Configure the default application registry.
- Navigate to System OAuth > Application Registry.
- Open the record, Survey Monkey.
-
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. Remarque :If you have provided additional scopes, create records for those scopes in the OAuth Entity Scopes tab.
-
Create a credential record.
- Navigate to Connections & Credentials > Credentials.
-
Click New.
The system displays the message What type of Credentials would you like to create?.
- Select OAuth 2.0 Credentials.
-
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. - Right-click the form header and click Save.
-
Create a connection record.
- Navigate to Connections & Credentials > Connection & Credential Aliases.
- Open for the record for SurveyMonkey.
-
From the Connections tab, click
New.
The system displays a blank HTTP(s) Connection form.
-
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. - Facultatif : In the Attributes tab, provide your SurveyMonkey API version if it is different than the default value of v3.
- Click Submit.
The ServiceNow instance and SurveyMonkey account are integrated.