Skip to main content

Overview

Platform for IT service management, operations automation, and workflow orchestration. Through Langdock’s integration, you can access and manage ServiceNow directly from your conversations.
Authentication: OAuth Category: Productivity & Collaboration Availability: All workspace plans

Available Actions

Find configuration items

servicenow.find_configuration_items
Finds configuration items based on a query. Requires Confirmation: No Parameters:
  • fields (TEXT, Optional): Comma-separated list or JSON array of field names to return (sysparm_fields).
  • maxResults (TEXT, Optional): Maximum number of configuration items to return. The action auto-paginates until this number is reached or no more data.
  • query (TEXT, Optional): ServiceNow encoded query (string) for cmdb_ci. Leave empty to return recent CIs. ServiceNow’s Configuration Items has multiple classes (servers, applications, network gear, etc.) that extend this base table. Each CI record’s sys_class_name indicates the specific CI class it belongs to. Key concep…
  • displayValue (TEXT, Optional): Return display values for reference fields (sysparm_display_value). Accepts true, false, or all.
  • excludeReferenceLink (TEXT, Optional): Exclude _ref_link properties in responses (sysparm_exclude_reference_link).
Output: Returns the operation result

Find groups

servicenow.find_groups
Finds groups based on a query. Requires Confirmation: No Parameters:
  • fields (TEXT, Optional): Comma-separated list or JSON array of field names to return (sysparm_fields).
  • query (TEXT, Optional): ServiceNow encoded query (string) for sys_user_group. Leave empty to return recent groups.
  • displayValue (TEXT, Optional): Return display values for reference fields (sysparm_display_value). Accepts true, false, or all.
  • maxResults (TEXT, Optional): Maximum number of groups to return. The action auto-paginates until this number is reached or no more data.
  • excludeReferenceLink (TEXT, Optional): Exclude _ref_link properties in responses (sysparm_exclude_reference_link).
Output: Returns the operation result

Find incidents

servicenow.find_incidents
Finds ServiceNow incidents using a query. Requires Confirmation: No Parameters:
  • displayValue (SELECT, Optional): Return display values for reference fields (sysparm_display_value).
  • query (TEXT, Optional): ServiceNow encoded query (string) for the incident table. Combine conditions with carets. Syntax - AND: use ^ between conditions (all must be true) - OR: use ^OR between conditions (either side can be true) - New OR group: use ^NQ to start a new group, e.g. condA^condB^NQcondC^condD => (A AND B) …
  • maxResults (TEXT, Optional): Maximum number of incidents to return. The action auto-paginates until this number is reached or no more data.
  • fields (TEXT, Optional): Comma-separated list or JSON array of field names to return (sysparm_fields).
  • excludeReferenceLink (TEXT, Optional): Exclude _ref_link properties in responses (sysparm_exclude_reference_link).
Output: Returns the operation result

Find tasks

servicenow.find_tasks
Finds Tasks based on a query. Per default filters for tasks and service catalog tasks. Requires Confirmation: No Parameters:
  • maxResults (TEXT, Optional): Maximum number of tasks to return. The action auto-paginates until this number is reached or no more data.
  • query (TEXT, Optional): ServiceNow encoded query (string) for the task table. ServiceNow’s Task is a base class extended by many specialized entities representing different types of work items. Each record’s sys_class_name indicates which type it belongs to. Filtering by sys_class_name restricts results to those specifi…
  • fields (TEXT, Optional): Comma-separated list or JSON array of field names to return (sysparm_fields).
  • excludeReferenceLink (TEXT, Optional): Exclude _ref_link properties in responses (sysparm_exclude_reference_link).
  • displayValue (SELECT, Optional): Return display values for reference fields (sysparm_display_value).
Output: Returns the operation result

Find users

servicenow.find_users
Finds users based on a query. Requires Confirmation: No Parameters:
  • fields (TEXT, Optional): Comma-separated list or JSON array of field names to return (sysparm_fields).
  • excludeReferenceLink (TEXT, Optional): Exclude _ref_link properties in responses (sysparm_exclude_reference_link).
  • maxResults (TEXT, Optional): Maximum number of users to return. The action auto-paginates until this number is reached or no more data.
  • query (TEXT, Optional): ServiceNow encoded query (string) for sys_user. Leave empty to return recent users.
  • displayValue (TEXT, Optional): Return display values for reference fields (sysparm_display_value). Accepts true, false, or all.
Output: Returns the operation result

Get configuration item dependencies

servicenow.get_configuration_item_dependencies
Gets outbound and inbound dependencies for a configuration item. Requires Confirmation: No Parameters:
  • ciSysId (TEXT, Required): Configuration item sys_id to traverse from
  • includeTypeDetails (SELECT, Optional): If true, includes cmdb_rel_type name and descriptors.
  • maxDepth (TEXT, Optional): Traversal depth (1-5). Depth 1 returns direct dependencies only.
  • maxResults (TEXT, Optional): Maximum number of relationship edges to return (up to 1000).
  • direction (SELECT, Optional): Dependency direction: outbound (this CI depends on), inbound (depend on this CI), or both
  • ciFields (TEXT, Optional): Comma-separated or JSON array of CI fields to include for nodes (default sys_id,name,sys_class_name)
  • relTypeNames (TEXT, Optional): Optional filter: comma-separated or JSON array of cmdb_rel_type.name values
  • relTypeSysIds (TEXT, Optional): Optional filter: comma-separated or JSON array of cmdb_rel_type.sys_id values
Output: Returns the operation result

Get configuration item types

servicenow.get_configuration_item_types
Gets configuration items with core identifiers. Requires Confirmation: No Parameters:
  • classes (TEXT, Optional): Optional filter: comma-separated or JSON array of sys_class_name values to include
  • fields (TEXT, Optional): Comma-separated or JSON array of fields to return. Defaults to sys_id,name,sys_class_name,install_status,sys_updated_on
  • maxResults (TEXT, Optional): Maximum number of CIs to return (default 200).
  • displayValue (SELECT, Optional): Return display values for reference fields (sysparm_display_value).
  • excludeReferenceLink (TEXT, Optional): Exclude _ref_link properties in responses (sysparm_exclude_reference_link).
Output: Returns the operation result

Get incident

servicenow.get_incident
Gets a specific ServiceNow incident by sys_id with optional attachment download. Requires Confirmation: No Parameters:
  • incidentSysId (TEXT, Required): The sys_id of the incident to retrieve
  • includeAttachments (SELECT, Optional): Whether to download and include incident attachments in the response
  • fields (TEXT, Optional): Comma-separated list or JSON array of field names to return (sysparm_fields).
  • excludeReferenceLink (TEXT, Optional): Exclude _ref_link properties in responses (sysparm_exclude_reference_link).
  • displayValue (SELECT, Optional): Return display values for reference fields (sysparm_display_value).
Output: Returns the operation result

Get incident metadata

servicenow.get_incident_metadata
Gets field definitions for the incident table, including labels, data types, required flags, and allowed values for choice fields. Use this action to discover which fields are mandatory in your ServiceNow instance before creating or updating incidents. Set onlyRequired=true to get only mandatory fields. Custom fields and their requirements vary by instance. Requires Confirmation: No Parameters:
  • onlySettable (SELECT, Optional): If true (default), excludes read-only and calculated fields that cannot be set via API.
  • includeChoices (SELECT, Optional): Includes allowed values for choice fields from sys_choice (default true). All choices are fetched via pagination.
  • fields (TEXT, Optional): Optional comma-separated list or JSON array of field API names to include. By default, all fields are returned; use this only to inspect a subset (e.g., to get types or choices for a specific field).
  • onlyRequired (SELECT, Optional): If true, returns only fields that are mandatory at the dictionary level.
Output: Returns the operation result

Get task

servicenow.get_task
Gets a specific service now task. Requires Confirmation: No Parameters:
  • displayValue (TEXT, Optional): Return display values for reference fields (sysparm_display_value). Accepts true, false, or all.
  • fields (TEXT, Optional): Comma-separated list or JSON array of field names to return (sysparm_fields).
  • excludeReferenceLink (TEXT, Optional): Exclude _ref_link properties in responses (sysparm_exclude_reference_link).
  • taskSysId (TEXT, Required): The sys_id of the task to retrieve
Output: Returns the operation result

Create incident

servicenow.create_incident
Creates a new ServiceNow incident. Note: ServiceNow instances may have custom mandatory fields beyond short_description. If creation fails due to missing required fields, use get_incident_metadata with onlyRequired=true to discover instance-specific mandatory fields, then provide them via the additionalFields parameter. Requires Confirmation: Yes Parameters:
  • description (MULTI_LINE_TEXT, Optional): Detailed description of the incident.
  • callerId (TEXT, Optional): sys_id or identifier of the user reporting the incident (caller_id).
  • shortDescription (TEXT, Required): One-line summary of the incident (short_description).
  • category (TEXT, Optional): Incident category (e.g., network, software, hardware).
  • additionalFields (TEXT, Optional): JSON object for custom ServiceNow fields not listed above. Use get_incident_metadata with onlyRequired=true to discover mandatory fields in your instance, then provide them here. Field names use snake_case (e.g., u_custom_field, caller_id). Example: {“u_department”: “IT”, “u_location”: “HQ”}
  • attachments (FILE, Optional): Files to attach to the incident. Uploaded after the incident is created. Use when screenshots, logs, or supporting documents need to be included with the incident.
  • subcategory (TEXT, Optional): Incident subcategory (depends on category).
  • urgency (TEXT, Optional): Urgency level: 1 (High), 2 (Medium), 3 (Low).
  • assignmentGroup (TEXT, Optional): Group (sys_id) to assign the incident to.
  • assignedTo (TEXT, Optional): User (sys_id) to assign the incident to.
  • priority (TEXT, Optional): Priority value (optional; often derived from impact and urgency).
  • workNotes (MULTI_LINE_TEXT, Optional): Internal work notes added to the incident.
  • impact (TEXT, Optional): Business impact: 1 (High), 2 (Medium), 3 (Low).
Output: Returns the operation result

Comment on incident

servicenow.comment_on_incident
Creates a public comment or an internal work note for an incident. Requires Confirmation: Yes Parameters:
  • incidentSysId (TEXT, Required): The sys_id of the incident to comment on
  • isWorkNote (SELECT, Optional): If true, adds as work_notes (internal). If false, adds as comments (public)
  • comment (MULTI_LINE_TEXT, Required): Text to add as a comment (public) or work note (internal)
Output: Returns the operation result

Update configuration item dependencies

servicenow.update_configuration_item_dependencies
Adds or removes relationships for a base configuration item. Requires Confirmation: Yes Parameters:
  • addRelations (TEXT, Optional): JSON array or comma-separated of objects: {direction:‘outbound|inbound’, otherCiSysId:’…’, relTypeSysId?:’…’}. Example: [{“direction”:“outbound”,“otherCiSysId”:“55c3578bc0a8010e0117f727897d0011”,“relTypeSysId”:“1a9cb166f1571100a92eb60da2bce5c5”}]
  • baseCiSysId (TEXT, Required): The CI whose relationships should be updated
  • removeRelationSysIds (TEXT, Optional): JSON array or comma-separated list of cmdb_rel_ci sys_ids to delete
Output: Returns the operation result

Update incident

servicenow.update_incident
Updates fields of an existing incident. Requires Confirmation: Yes Parameters:
  • impact (TEXT, Optional): 1 High, 2 Medium, 3 Low
  • closeNotes (MULTI_LINE_TEXT, Optional): Set close_notes
  • additionalFields (TEXT, Optional): JSON object for custom ServiceNow fields not listed above. Use get_incident_metadata to discover available fields. Field names use snake_case (e.g., u_custom_field). Example: {“u_department”: “IT”, “u_location”: “HQ”}
  • assignedTo (TEXT, Optional): Assignee user sys_id
  • workNotes (MULTI_LINE_TEXT, Optional): Append to work_notes
  • state (TEXT, Optional): New state (e.g., 1 New, 2 In Progress, 3 On Hold, 6 Resolved, 7 Closed)
  • assignmentGroup (TEXT, Optional): Assignment group sys_id
  • incidentSysId (TEXT, Required): The sys_id of the incident to update
  • description (MULTI_LINE_TEXT, Optional): Update description
  • category (TEXT, Optional): Category
  • closeCode (TEXT, Optional): Set close_code
  • shortDescription (TEXT, Optional): Update short_description
  • subcategory (TEXT, Optional): Subcategory
  • urgency (TEXT, Optional): 1 High, 2 Medium, 3 Low
  • priority (TEXT, Optional): Priority (optional)
Output: Returns the operation result