Skip to content
All tools

servicenow_create_incident

ServiceNow · macOS · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Creates a real incident in the connected ServiceNow instance; the ticket is visible to the service desk as soon as it is created. Called without confirm it returns a preview of every field and sends nothing; pass confirm=true to create. urgency defaults to 3 (Medium). Returns the incident number, its sys_id and a link to it. To add to an existing incident use servicenow_add_comment or servicenow_update_incident instead of creating another.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — macOS
{
  "properties": {
    "category": {
      "description": "Incident category, e.g. 'software', 'hardware', 'network'",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to send; without it nothing is sent and the call returns a preview of every field.",
      "type": "boolean"
    },
    "description": {
      "description": "Full description of the issue",
      "type": "string"
    },
    "short_description": {
      "description": "Brief summary of the issue (required)",
      "type": "string"
    },
    "urgency": {
      "description": "1=Critical, 2=High, 3=Medium (default), 4=Low",
      "type": "string"
    }
  },
  "required": [
    "short_description"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "short_description": "Calendar search returns an empty result."
}

Windows

Purpose

Creates an incident in the ServiceNow instance connected with connect_servicenow, using the stored credentials. Without confirm=true nothing is sent: the answer previews every field, because a confirmed call files a real ticket in a system other people work from; show the user the text and get their go-ahead before confirming. Only a blank short_description is refused; urgency is 3 when omitted. Nothing checks for a similar open incident, so calling twice files two: look first with servicenow_search_incidents or servicenow_list_my_incidents. The reply gives the incident number and a link. This server cannot delete an incident; to change or close one, pass its sys_id (from servicenow_get_incident) to servicenow_update_incident.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — Windows
{
  "properties": {
    "category": {
      "description": "e.g. software, hardware, network",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to send. Without it nothing is sent and the answer previews every field.",
      "type": "boolean"
    },
    "description": {
      "description": "Full description",
      "type": "string"
    },
    "short_description": {
      "description": "Brief summary (required)",
      "type": "string"
    },
    "urgency": {
      "description": "1=Critical, 2=High, 3=Medium (default), 4=Low",
      "type": "string"
    }
  },
  "required": [
    "short_description"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "short_description": "Calendar search returns an empty result."
}