The ServiceNow connector lets you manage users, group memberships, and incidents in ServiceNow from your PingOne DaVinci flow.
You can use the ServiceNow connector to:
- Create, deactivate, modify, and search for users
- Add users to groups
- Read, create, and modify incidents
Setup
Resources
For information and setup help, see the following documentation:
- DaVinci documentation:
Requirements
To use the connector, you'll need:
- A ServiceNow license
Configuring the ServiceNow connector
Add the connector in DaVinci as shown in Adding a connector, then configure it as follows.
Connector configuration
API URL
Admin Username
Admin Password
Using the connector in a flow
Searching for users
There are two ways to search for users with the ServiceNow connector:
- Search for a specific user by user ID using the Search User capability.
- Search for multiple users based on their attributes using the Search capability.
No special flow configuration is needed. Add the capability you want and populate its properties according to the help text.
Managing users
The connector has two capabilities that allow you to create, modify, activate, and deactivate users in ServiceNow:
- Create User
- Modify User
No special flow configuration is needed. Add the capability and populate its properties according to the help text.
Managing group memberships
The Add User to Group connector allows you to manage the groups that a user belongs to in ServiceNow:
No special flow configuration is needed. Add the capability and populate its properties according to the help text.
Managing incidents
The connector has several capabilities that allow you to manage incidents in ServiceNow:
- Read an incident
- Create an incident
- Modify an incident
No special flow configuration is needed. Add the capability and populate its properties according to the help text.
Limitations
ServiceNow does not provide support for:
- Deleting users
- Removing users from groups
- Deleting incidents
Capabilities
- Search User
-
Search a single user by the Service Now ID.
Details- Details
-
- Properties
-
-
User System ID
textFieldrequired -
System ID associated with the user
-
User System ID
- Output Schema
-
-
output
object -
-
rawResponse
object -
properties
object -
-
result
object -
properties
object -
-
calendar_integration
string -
country
string -
user_password
string -
last_login_time
string -
x_pd_integration_pagerduty_id
string -
hashed_user_id
string -
source
string -
sys_updated_on
string -
building
string -
web_service_access_only
string -
notification
string -
enable_multifactor_authn
string -
sys_updated_by
string -
sso_source
string -
sys_created_on
string -
sys_domain
object -
properties
object -
-
link
string -
value
string
-
link
-
state
string -
vip
string -
sys_created_by
string -
zip
string -
home_phone
string -
time_format
string -
last_login
string -
default_perspective
string -
active
string -
sys_domain_path
string -
cost_center
string -
phone
string -
name
string -
employee_number
string -
password_needs_reset
string -
gender
string -
city
string -
failed_attempts
string -
user_name
string -
roles
string -
title
string -
sys_class_name
string -
sys_id
string -
internal_integration_user
string -
ldap_server
string -
mobile_phone
string -
street
string -
company
string -
first_name
string -
email
string -
introduction
string -
preferred_language
string -
manager
string -
locked_out
string -
sys_mod_count
string -
last_name
string -
photo
string -
avatar
string -
middle_name
string -
sys_tags
string -
time_zone
string -
schedule
string -
date_format
string -
location
string
-
calendar_integration
-
result
-
statusCode
number -
headers
object
-
rawResponse
-
output
- Search for Users
-
Search for users based on an attribute filter.
Details- Details
-
- Properties
-
-
Number of results
textField -
Max number of results
-
Email
textField -
Users email.
-
First Name
textField -
User first name
-
Last Name
textField -
User last name
-
Query Parameters
keyValueList -
Define additional query parameters to send to Service Now. For help, see the Service Now user table documentation.
-
Number of results
- Output Schema
-
-
output
object -
-
rawResponse
object -
properties
object -
-
result
array -
items
array -
-
type
object - properties
-
type
-
result
-
statusCode
number -
headers
object
-
rawResponse
-
output
- Delete a User
-
Delete a user by the Service Now ID.
Details- Details
-
- Properties
-
-
User System ID
textFieldrequired -
System ID associated with the user
-
User System ID
- Output Schema
-
-
output
object -
-
statusCode
number -
headers
object
-
statusCode
-
output
- Create a User
-
Create a new user.
Details- Details
-
- Properties
-
-
Username
textField -
Username
-
First Name
textField -
User first name
-
Middle Name
textField -
User middle name
-
Last Name
textField -
User last name
-
Phone
textField -
User phone
-
Email
textField -
Users email.
-
Activate the User
toggleSwitch -
User status
-
Group
dropDown -
List of Instance Groups.
-
City
textField -
The user's city.
-
Employee Number
textField -
The user's employee number.
-
Custom Attributes
keyValueList -
Additional attributes for user creation or modification.
-
Username
- Output Schema
-
-
output
object -
-
rawResponse
object -
properties
object -
-
result
object -
properties
object -
-
country
string -
user_password
string -
gender
string -
city
string -
sys_import_state_comment
string -
template_import_log
string -
sys_updated_on
string -
sys_class_name
string -
sys_target_sys_id
object -
properties
object -
-
link
string -
value
string
-
link
-
notification
string -
sys_id
string -
sys_updated_by
string -
sys_created_on
string -
sys_import_set
object -
properties
object -
-
link
string -
value
string
-
link
-
sys_transform_map
object -
properties
object -
-
link
string -
value
string
-
link
-
first_name
string -
email
string -
preferred_language
string -
sys_created_by
string -
group
string -
sys_import_row
string -
home_phone
string -
sys_row_error
string -
sys_target_table
string -
locked_out
string -
sys_mod_count
string -
active
string -
last_name
string -
import_set_run
object -
properties
object -
-
link
string -
value
string
-
link
-
middle_name
string -
sys_tags
string -
sys_import_state
string -
phone
string -
employee_number
string -
mobile_number
string -
username
string -
group_record_id
string -
group_sys_id
string
-
country
-
result
-
statusCode
number -
headers
object
-
rawResponse
-
output
- Remove a User from a Group
-
Remove user from a group.
Details- Details
-
- Properties
-
-
User System ID
textFieldrequired -
System ID associated with the user
-
Remove Group
dropDownrequired -
Removes the user from a specific group.
- Use Group ID (Default)
-
Remove Group ID
textField -
Insert group ID or select on from the Group drop down menu.
-
User System ID
- Output Schema
-
-
output
object -
-
statusCode
number -
headers
object
-
statusCode
-
output
- Add a User to a Group
-
Add a user to a group.
Details- Details
-
- Properties
-
-
User System ID
textFieldrequired -
System ID associated with the user
-
Add Group
dropDown -
Add User to a specific group.
-
User System ID
- Output Schema
-
-
output
object -
-
statusCode
number -
headers
object
-
statusCode
-
output
- Modify a User
-
Modify a user.
Details- Details
-
- Properties
-
-
User System ID
textFieldrequired -
System ID associated with the user
-
Username
textField -
Username.
-
First Name
textField -
User first name
-
Middle Name
textField -
User middle name.
-
Last Name
textField -
User last name
-
Phone
textField -
User phone
-
Email
textField -
Users email.
-
Activate the User
toggleSwitch -
User status
-
Lock the User Out
dropDown -
When enabled, the user is locked out of ServiceNow.
- Locked
- Active
-
Custom Attributes
keyValueList -
Additional attributes for user creation or modification.
-
User System ID
- Output Schema
-
-
output
object -
-
rawResponse
object -
properties
object -
-
result
object -
properties
object -
-
calendar_integration
string -
country
string -
user_password
string -
last_login_time
string -
x_pd_integration_pagerduty_id
string -
hashed_user_id
string -
source
string -
sys_updated_on
string -
building
string -
web_service_access_only
string -
notification
string -
enable_multifactor_authn
string -
sys_updated_by
string -
sso_source
string -
sys_created_on
string -
sys_domain
object -
properties
object -
-
link
string -
value
string
-
link
-
state
string -
vip
string -
sys_created_by
string -
zip
string -
home_phone
string -
time_format
string -
last_login
string -
default_perspective
string -
active
string -
sys_domain_path
string -
cost_center
string -
phone
string -
name
string -
employee_number
string -
password_needs_reset
string -
gender
string -
city
string -
failed_attempts
string -
user_name
string -
roles
string -
title
string -
sys_class_name
string -
sys_id
string -
internal_integration_user
string -
ldap_server
string -
mobile_phone
string -
street
string -
company
string -
department
string -
first_name
string -
email
string -
introduction
string -
preferred_language
string -
manager
string -
locked_out
string -
sys_mod_count
string -
last_name
string -
photo
string -
avatar
string -
middle_name
string -
sys_tags
string -
time_zone
string -
schedule
string -
date_format
string -
location
string
-
calendar_integration
-
result
-
statusCode
number -
headers
object
-
rawResponse
-
output
- Create an Incident
-
Create a new incident.
Details- Details
-
- Properties
-
-
Caller ID
textField -
System ID for the caller.
-
Category
dropDown -
Incident Categories.
-
Subcategory
dropDown -
Incident Subcategories.
-
Service
dropDown -
Services.
-
Configuration Item ID
textField -
System ID for the configuration item.
-
Short description
textArea -
Provide a short description for the incident.
-
Description
textArea -
Provide a description for the incident.
-
Channel
dropDown -
Channel in which the incident was reported.
-
Status
dropDown -
Incident status.
-
Impact
dropDown -
Impact of the incident.
-
Urgency
dropDown -
Urgency of the incident.
-
Group
dropDown -
List of Instance Groups.
-
Custom Attributes
keyValueList -
Additional attributes for user creation or modification.
-
Caller ID
- Output Schema
-
-
output
object -
-
rawResponse
object -
properties
object -
-
result
object -
properties
object -
-
x_pd_integration_conf_bridge
string -
parent
string -
made_sla
string -
caused_by
string -
watch_list
string -
upon_reject
string -
sys_updated_on
string -
child_incidents
string -
hold_reason
string -
origin_table
string -
task_effective_number
string -
approval_history
string -
number
string -
resolved_by
string -
sys_updated_by
string -
opened_by
object -
properties
object -
-
link
string -
value
string
-
link
-
user_input
string -
sys_created_on
string -
sys_domain
object -
properties
object -
-
link
string -
value
string
-
link
-
x_pd_integration_incident
string -
state
string -
route_reason
string -
sys_created_by
string -
knowledge
string -
order
string -
calendar_stc
string -
closed_at
string -
cmdb_ci
string -
delivery_plan
string -
contract
string -
impact
string -
active
string -
work_notes_list
string -
business_service
object -
properties
object -
-
link
string -
value
string
-
link
-
business_impact
string -
priority
string -
sys_domain_path
string -
rfc
string -
time_worked
string -
expected_start
string -
opened_at
string -
business_duration
string -
group_list
string -
work_end
string -
caller_id
object -
properties
object -
-
link
string -
value
string
-
link
-
reopened_time
string -
resolved_at
string -
approval_set
string -
subcategory
string -
work_notes
string -
x_pd_integration_incident_id
string -
universal_request
string -
short_description
string -
close_code
string -
correlation_display
string -
delivery_task
string -
work_start
string -
assignment_group
object -
properties
object -
-
link
string -
value
string
-
link
-
additional_assignee_list
string -
business_stc
string -
cause
string -
description
string -
origin_id
string -
calendar_duration
string -
close_notes
string -
notify
string -
service_offering
string -
sys_class_name
string -
closed_by
string -
follow_up
string -
parent_incident
string -
sys_id
string -
contact_type
string -
reopened_by
string -
incident_state
string -
urgency
string -
problem_id
string -
company
string -
reassignment_count
string -
x_pd_integration_incident_key
string -
activity_due
string -
assigned_to
string -
severity
string -
comments
string -
approval
string -
sla_due
string -
comments_and_work_notes
string -
due_date
string -
sys_mod_count
string -
reopen_count
string -
sys_tags
string -
escalation
string -
upon_approval
string -
correlation_id
string -
location
string -
category
string
-
x_pd_integration_conf_bridge
-
result
-
statusCode
number -
headers
object
-
rawResponse
-
output
- Read an Incident
-
Search for an incident by the incident number or by the ServiceNow ID.
Details- Details
-
- Properties
-
-
Incident Search Attribute
dropDownrequired -
Choose an option to search for incident.
- Use Incident ID (Default)
- Use Incident number
-
Incident Number
textFieldrequired -
Record number for the incident, found as the property "task_effective_number".
-
Incident ID
textFieldrequired -
System ID for the incident.
-
Incident Search Attribute
- Output Schema
-
-
output
object -
-
rawResponse
object -
properties
object -
-
result
object -
properties
object -
-
x_pd_integration_conf_bridge
string -
parent
string -
made_sla
string -
caused_by
string -
watch_list
string -
upon_reject
string -
sys_updated_on
string -
child_incidents
string -
hold_reason
string -
origin_table
string -
task_effective_number
string -
approval_history
string -
number
string -
resolved_by
string -
sys_updated_by
string -
opened_by
object -
properties
object -
-
link
string -
value
string
-
link
-
user_input
string -
sys_created_on
string -
sys_domain
object -
properties
object -
-
link
string -
value
string
-
link
-
x_pd_integration_incident
string -
state
string -
route_reason
string -
sys_created_by
string -
knowledge
string -
order
string -
calendar_stc
string -
closed_at
string -
cmdb_ci
string -
delivery_plan
string -
contract
string -
impact
string -
active
string -
work_notes_list
string -
business_service
object -
properties
object -
-
link
string -
value
string
-
link
-
business_impact
string -
priority
string -
sys_domain_path
string -
rfc
string -
time_worked
string -
expected_start
string -
opened_at
string -
business_duration
string -
group_list
string -
work_end
string -
caller_id
object -
properties
object -
-
link
string -
value
string
-
link
-
reopened_time
string -
resolved_at
string -
approval_set
string -
subcategory
string -
work_notes
string -
x_pd_integration_incident_id
string -
universal_request
string -
short_description
string -
close_code
string -
correlation_display
string -
delivery_task
string -
work_start
string -
assignment_group
object -
properties
object -
-
link
string -
value
string
-
link
-
additional_assignee_list
string -
business_stc
string -
cause
string -
description
string -
origin_id
string -
calendar_duration
string -
close_notes
string -
notify
string -
service_offering
string -
sys_class_name
string -
closed_by
string -
follow_up
string -
parent_incident
string -
sys_id
string -
contact_type
string -
reopened_by
string -
incident_state
string -
urgency
string -
problem_id
string -
company
string -
reassignment_count
string -
x_pd_integration_incident_key
string -
activity_due
string -
assigned_to
string -
severity
string -
comments
string -
approval
string -
sla_due
string -
comments_and_work_notes
string -
due_date
string -
sys_mod_count
string -
reopen_count
string -
sys_tags
string -
escalation
string -
upon_approval
string -
correlation_id
string -
location
string -
category
string
-
x_pd_integration_conf_bridge
-
result
-
statusCode
number -
headers
object
-
rawResponse
-
output
- Delete an Incident
-
Delete an incident by the ServiceNow ID.
Details- Details
-
- Properties
-
-
Incident ID
textFieldrequired -
System ID for the incident.
-
Incident ID
- Output Schema
-
-
output
object -
-
statusCode
number -
headers
object
-
statusCode
-
output
- Modify an Incident
-
Modify an incident by its ServiceNow ID.
Details- Details
-
- Properties
-
-
Incident ID
textFieldrequired -
System ID for the incident.
-
Caller ID
textField -
System ID for the caller.
-
Category
dropDown -
Incident Categories.
-
Subcategory
dropDown -
Incident Subcategories.
-
Service
dropDown -
Services.
-
Configuration Item ID
textField -
System ID for the configuration item.
-
Short description
textArea -
Provide a short description for the incident.
-
Description
textArea -
Provide a description for the incident.
-
Channel
dropDown -
Channel in which the incident was reported.
-
Status
dropDown -
Incident status.
-
Impact
dropDown -
Impact of the incident.
-
Urgency
dropDown -
Urgency of the incident.
-
Group
dropDown -
List of Instance Groups.
-
Custom Attributes
keyValueList -
Additional attributes for user creation or modification.
-
Incident ID
- Output Schema
-
-
output
object -
-
rawResponse
object -
properties
object -
-
result
object -
properties
object -
-
x_pd_integration_conf_bridge
string -
parent
string -
made_sla
string -
caused_by
string -
watch_list
string -
upon_reject
string -
sys_updated_on
string -
child_incidents
string -
hold_reason
string -
origin_table
string -
task_effective_number
string -
approval_history
string -
number
string -
resolved_by
string -
sys_updated_by
string -
opened_by
object -
properties
object -
-
link
string -
value
string
-
link
-
user_input
string -
sys_created_on
string -
sys_domain
object -
properties
object -
-
link
string -
value
string
-
link
-
x_pd_integration_incident
string -
state
string -
route_reason
string -
sys_created_by
string -
knowledge
string -
order
string -
calendar_stc
string -
closed_at
string -
cmdb_ci
string -
delivery_plan
string -
contract
string -
impact
string -
active
string -
work_notes_list
string -
business_service
object -
properties
object -
-
link
string -
value
string
-
link
-
business_impact
string -
priority
string -
sys_domain_path
string -
rfc
string -
time_worked
string -
expected_start
string -
opened_at
string -
business_duration
string -
group_list
string -
work_end
string -
caller_id
object -
properties
object -
-
link
string -
value
string
-
link
-
reopened_time
string -
resolved_at
string -
approval_set
string -
subcategory
string -
work_notes
string -
x_pd_integration_incident_id
string -
universal_request
string -
short_description
string -
close_code
string -
correlation_display
string -
delivery_task
string -
work_start
string -
assignment_group
object -
properties
object -
-
link
string -
value
string
-
link
-
additional_assignee_list
string -
business_stc
string -
cause
string -
description
string -
origin_id
string -
calendar_duration
string -
close_notes
string -
notify
string -
service_offering
string -
sys_class_name
string -
closed_by
string -
follow_up
string -
parent_incident
string -
sys_id
string -
contact_type
string -
reopened_by
string -
incident_state
string -
urgency
string -
problem_id
string -
company
string -
reassignment_count
string -
x_pd_integration_incident_key
string -
activity_due
string -
assigned_to
string -
severity
string -
comments
string -
approval
string -
sla_due
string -
comments_and_work_notes
string -
due_date
string -
sys_mod_count
string -
reopen_count
string -
sys_tags
string -
escalation
string -
upon_approval
string -
correlation_id
string -
location
string -
category
string
-
x_pd_integration_conf_bridge
-
result
-
statusCode
number -
headers
object
-
rawResponse
-
output