> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.12/investigate-and-respond-to-threats/day-to-day-tasks-in-cortex-xsoar/incident-management/create-an-incident.md). # Create an Incident Cortex XSOAR incidents can be created manually, from a JSON file, from the Cortex XSOAR RESTful API, or from an integration feed. {% hint style="info" %} ### Note The import JSON feature enables you to import event data from third-party software and use it to create new incidents in Cortex XSOAR. These incidents can be used to build and troubleshoot playbooks for integrations that have not yet been installed or configured. {% endhint %} * Create an incident manually. Go to the **Incidents** page, click **New Incident** and enter relevant data, including custom fields if needed. * Create an incident from a JSON file. 1. Go to Settings → OBJECTS SETUP → Incidents → **Classification & Mapping** and click the mapper you want to use. 2. From the **Get Data** drop-down, choose **Upload JSON**, click on the paper clip icon and upload the JSON file. 3. [Map the fields](/xsoar-6-administrator-guide/6.12/configure-cortex-xsoar/customize-and-configure-cortex-xsoar/incidents/classification-and-mapping.md#UUID-4c41731c-1ace-37ae-99d7-972b74a7cc55_id2794d8a6-02ae-4cde-92a8-9eae712fd2cf). 4. From the ![market-gear.png](/files/cYGiNnW6ktZQ2EXjoduO)menu, select **Create Incident from JSON**. Select the incident type and **Create Incident**.

Note

To export an incident to a JSON file, run the !js script="return ${.}" command in the War Room. You can then import the JSON file, for example, in a development environment for mapping and testing.

* Create an incident via the API. To view the full REST API documentation, select Settings → INTEGRATIONS → API Keys → **View Cortex XSOAR API**. To create a single incident via the API, use the /incident route. If you create an incident via the API and do not set **createInvestigation** to true, the incident will be created but an investigation will not be opened and a playbook will not automatically run. To create multiple incidents, use /incident/batch. The minimum information required to create a single incident via the API is the incident name. * [Fetch Incidents From an Integration Instance](/xsoar-6-administrator-guide/6.12/configure-cortex-xsoar/customize-and-configure-cortex-xsoar/incidents/incident-lifecycle.md#UUID-e15bd3a7-3a30-1226-e131-e18a578a93d0). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.12/investigate-and-respond-to-threats/day-to-day-tasks-in-cortex-xsoar/incident-management/create-an-incident.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.