---
title: "POST Urgency"
slug: "post-urgency"
updated: 2026-08-30T07:52:29Z
published: 2026-08-30T07:52:29Z
canonical: "help.symphonysummitai.com/post-urgency"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.symphonysummitai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST Urgency

The POST Urgency Incident Master API creates a new Urgency master record in the Incident Management (IM) module. Authorized administrators, integrations, and automation tools can create Urgency records without using the application UI.

## Endpoint

```http
POST /API/v1/Master/IM/Urgency
```

## Path Details

| Path Value | Description |
| --- | --- |
| `IM` | Module code for Incident Management. |
| `Urgency` | Master entity in which the API creates the new record. |

> **Note:** Before creating an Urgency record, system retrieves its metadata to review required fields, supported fields, payload structure, constraints, and applicable endpoints. `GET /API/v1/Master/IM/Urgency/metadata?sections=create`.

### Sample Metadata Request

```bash
curl --location 'https://<host>/API/v1/Master/IM/Urgency/metadata?sections=create' \
  --request GET \
  --header 'Accept: application/json' \
  --header 'X-Api-Key: <API_KEY>'
```

## Request Headers

| Header | Value | Required | Description |
| --- | --- | --- | --- |
| `Accept` | `application/json` | Yes | Specifies the expected response format. |
| `Content-Type` | `application/json` | Yes | Specifies that the request body is in JSON format. |
| `X-Api-Key` | `&lt;API_KEY&gt;` | Yes | API key used to authenticate the request. |

## Sample Payload

```json
{
  "Active": true,
  "Text": "Sample Urgency Name",
  "Is_Default": false,
  "Sort_Order": 0,
  "Instance": "Info"
}
```

### Sample Payload Field Details

| Field Name | Sample Value | Data Type | Description |
| --- | --- | --- | --- |
| Active | `true` | Boolean | Indicates whether the Urgency record is active and available for use. |
| Text | `"Sample Urgency Name"` | String | Specifies the display name of the Urgency record. |
| Is_Default | `false` | Boolean | Indicates whether the Urgency acts as the default Urgency value. |
| Sort_Order | `0` | Integer | Specifies the display or processing order of the Urgency record. |
| Instance | `"Info"` | String | Specifies the application instance associated with the Urgency record. |

> **Note:** While creating a Default Urgency by setting Is_Default: true, only one default Urgency must exist, setting more than one will return error.

## Sample Request

```bash
curl --location 'https://<host>/API/v1/Master/IM/Urgency' \
  --request POST \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <API_KEY>' \
  --data-raw '{
    "Active": true,
    "Text": "Sample Urgency Name",
    "Is_Default": false,
    "Sort_Order": 0,
    "Instance": "Info"
  }'
```

### Sample Request Details

| Component | Value | Description |
| --- | --- | --- |
| HTTP Method | `POST` | Creates a new Urgency master record. |
| Endpoint URL | `https://&lt;host&gt;/API/v1/Master/IM/Urgency` | API endpoint used to create an Urgency record. |
| Host | `&lt;host&gt;` | Base URL of the target environment, such as Development, Test, or Production. |
| API Version | `v1` | Identifies Version 1 of the API. |
| Resource Group | `Master` | Identifies the Master Data API resource group. |
| Module | `IM` | Identifies the Incident Management module. |
| Master Name | `Urgency` | Identifies the Urgency master entity. |
| Accept Header | `application/json` | Indicates that the client expects the response in JSON format. |
| Content-Type Header | `application/json` | Indicates that the request body contains JSON data. |
| X-Api-Key Header | `&lt;API_KEY&gt;` | API key used to authenticate and approve the request. |
| Request Body | JSON payload | Contains the values used to create the Urgency record. |

### Request Body Details

| Field Name | Sample Value | Data Type | Required | Description |
| --- | --- | --- | --- | --- |
| Active | `true` | Boolean | Yes | Creates the Urgency as an active record that is available for use. |
| Text | `"Sample Urgency Name"` | String | Yes | Sets the display name of the Urgency record. |
| Is_Default | `false` | Boolean | Yes | Specifies that the Urgency is not the default Urgency value. |
| Sort_Order | `0` | Integer | Yes | Sets the display or processing order of the Urgency record. |
| Instance | `"Info"` | String | Yes | Associates the Urgency with the specified application instance. |

The request creates an active Urgency record named `Sample Urgency Name`, does not set the record as the default Urgency, assigns a sort order of `0`, and associates the record with the specified application instance.

## Sample Success Response

### HTTP 201 Created

```json
{
  "message": "Master record created successfully.",
  "data": {
    "success": true,
    "recordId": 17,
    "displayName": "Urgency",
    "moduleCode": "IM",
    "operation": "INSERT",
    "rowsAffected": 1
  },
  "executionTime": 0.0553389
}
```

A successful request creates the Urgency record and returns the generated record identifier and execution details.

### Sample Success Response Field Details

| Field Name | Sample Value | Data Type | Description |
| --- | --- | --- | --- |
| message | `"Master record created successfully."` | String | Confirms that the system created the Urgency record successfully. |
| data | Response object | Object | Contains details about the completed create operation. |
| data.success | `true` | Boolean | Indicates whether the Urgency create operation succeeded. |
| data.recordId | `17` | Integer | Unique identifier generated for the newly created Urgency record. |
| data.displayName | `"Urgency"` | String | Identifies the master entity the system created. |
| data.moduleCode | `"IM"` | String | Identifies the Incident Management module associated with the new record. |
| data.operation | `"INSERT"` | String | Indicates that the API performed an insert operation. |
| data.rowsAffected | `1` | Integer | Indicates the number of Urgency records created by the request. |
| executionTime | `0.0553389` | Number | Indicates the time taken to process the request, in seconds. |

A successful request returns HTTP `201 Created`. The response confirms that the system created a new Urgency record, the generated record ID is `17`, and the request affected one record.

## Error Responses

### 400 Bad Request

```json
{
  "message": "Invalid request payload.",
  "errorCode": 400,
  "details": "One or more fields failed validation."
}
```

### 401 Unauthorized

```json
{
  "message": "Unauthorized access.",
  "errorCode": 401,
  "details": "Valid API credentials are required."
}
```

### 403 Forbidden

```json
{
  "message": "You do not have permission to create master records.",
  "errorCode": 403,
  "details": "The authenticated user lacks the required privileges to perform this operation."
}
```

### 404 Not Found

```json
{
  "message": "Master entity not found.",
  "errorCode": 404,
  "details": "The requested master entity or endpoint does not exist."
}
```