Create Incident

Create a new incident.

Note: It is required to configure Primary Contact - ID or Lookup Name.

External Documentation

To learn more, visit the Oracle Service Cloud documentation.

Basic Parameters

Parameter	Description
Account - Lookup Name	The lookup name of the account to assign the incident to.
Application Context	The application context information to attach as OSvC-CREST-Application-Context request header. For more information, please refer to Oracle documentation.
Assign Primary Account	Select the attribute used to identify the primary contact. Note: A primary contact must be assigned to the created incident. This can be done using the contact’s ID or Lookup Name.
Assign To Account	Select to fill account details to assign the incident to. Note: To represent an account - one of ID or Lookup Name is required.
Assign To Staff Group	Select to fill staff group details to assign the incident to. Note: To represent a staff group - one of ID or Lookup Name is required.
Assignment - Account ID	The ID of the account to assign the incident to.
Lookup Name	The lookup name of the incident. Maximum length is 255.
Primary Contact - ID	The ID of the primary contact to assign the incident to.
Primary Contact - Lookup Name	The lookup name of the primary contact to assign the incident to.
Staff Group - ID	The ID of the staff group to assign the incident to.
Staff Group - Lookup Name	The lookup name of the staff group to assign the incident to.
Subject	The description of the incident to create. Maximum length is 240.

Advanced Parameters

Parameter	Description
Additional Parameters	A JSON object for additional body parameters. Values specified in this parameter will override equivalent parameters. For example: { “first_key”: 12345, “second_key”: “some_value” } The object must follow the vendor’s structure as defined in the API documentation.
File Attachments	A list of file objects to attach to the incident. For example: [ { “updatedTime”: “2025-01-10T12:45:00Z”, “contentType”: “text/plain”, “name”: “Log File”, “uRL”: “https://example.com/files/12345”, “description”: “System-generated log file attachment.”, “private”: false, “fileName”: “system_log.txt”, “createdTime”: “2025-01-10T12:30:00Z”, “data”: “VGhpcyBpcyBhIHNhbXBsZSBsb2cgZmlsZS4=”, “id”: 12345, “size”: 2048 } ]
Language	Select to fill language details. Note: To represent a language - one of ID or Lookup Name is required.
Language - Lookup Name	The lookup name of the language. Maximum length is 255.
Language ID	The ID of the language. Valid range is 1-9223372036854776000.
Next Request After	The time (in milliseconds) that must elapse before subsequent API calls will be executed. This value will be attached as osvc-crest-next-request-after request header. For more information, please refer to Oracle documentation.

Example Output

{
	"id": 67,
	"lookupName": "160128-000000",
	"createdTime": "2016-01-28T21:06:35.000Z",
	"updatedTime": "2016-01-28T21:06:35.000Z",
	"primaryContact": {
		"links": [
			{
				"rel": "self",
				"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/2"
			},
			{
				"rel": "canonical",
				"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/2"
			},
			{
				"rel": "describedby",
				"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/contacts"
			}
		]
	},
	"subject": "FishPhone not working",
	"threads": {
		"links": [
			{
				"rel": "self",
				"href": "https://mysite.example.com/services/rest/connect/v1.4/incidents/32/threads"
			}
		]
	},
	"links": [
		{
			"rel": "self",
			"href": "https://mysite.example.com/services/rest/connect/v1.4/incidents/32"
		},
		{
			"rel": "canonical",
			"href": "https://mysite.example.com/services/rest/connect/v1.4/incidents/32"
		},
		{
			"rel": "describedby",
			"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/incidents"
		},
		{
			"rel": "alternate",
			"href": "https://mysite.example.com/services/rest/connect/v1.4/incidents/32",
			"mediaType": "application/schema+json"
		}
	]
}