Create Incident

Create a new incident.

Note that if the incident mode is set to “retrospective” then the new incident will not be announced in Slack.

External Documentation

To learn more, visit the incident.io documentation.

Basic Parameters

Parameter	Description
Idempotency Key	Unique string used to de-duplicate incident create requests.
Name	Explanation of the incident.
Summary	Detailed description of the incident.
Visibility	Whether the incident should be open to anyone in your Slack workspace (public), or invite-only (private). For more information on Private Incidents see our help centre.

Advanced Parameters

Parameter	Description
Custom Field Entries	Set the incident’s custom fields to these values.
ID	Unique identifier for the incident.
Incident Role Assignments	Assign incident roles to these people.
Incident Status ID	Incident status to assign to the incident.
Incident Timestamp Values	Assign the incident’s timestamps to these values.
Incident Type ID	Incident type to create this incident as.
Mode	Whether the incident is real, a test, a tutorial, or importing as a retrospective incident.
Retrospective Incident Options Slack Channel ID	If the incident mode is ‘retrospective’, pass the ID of a Slack channel in your workspace to attach the incident to an existing channel, rather than creating a new one.
Severity ID	Severity to create incident as.
Slack Channel Name Override	Name of the Slack channel to create for this incident.
Slack Team ID	Slack Team to create the incident in.

Example Output

{
	"incident": {
		"call_url": "https://zoom.us/foo",
		"created_at": "2021-08-17T13:28:57.801578Z",
		"creator": {
			"api_key": {
				"id": "01FCNDV6P870EA6S7TK1DSYDG0",
				"name": "My test API key"
			},
			"user": {
				"email": "[e-mail]",
				"id": "01FCNDV6P870EA6S7TK1DSYDG0",
				"name": "Lisa Karlin Curtis",
				"role": "viewer",
				"slack_user_id": "U02AYNF2XJM"
			}
		},
		"custom_field_entries": [
			{
				"custom_field": {
					"description": "Which team is impacted by this issue",
					"field_type": "single_select",
					"id": "01FCNDV6P870EA6S7TK1DSYDG0",
					"name": "Affected Team",
					"options": [
						{
							"custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
							"id": "01FCNDV6P870EA6S7TK1DSYDG0",
							"sort_key": 10,
							"value": "Product"
						}
					]
				},
				"values": [
					{
						"value_catalog_entry": {
							"aliases": [
								"[e-mail]",
								"lawrence"
							],
							"external_id": "761722cd-d1d7-477b-ac7e-90f9e079dc33",
							"id": "01FCNDV6P870EA6S7TK1DSYDG0",
							"name": "Primary On-call"
						},
						"value_link": "https://google.com/",
						"value_numeric": "123.456",
						"value_option": {
							"custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
							"id": "01FCNDV6P870EA6S7TK1DSYDG0",
							"sort_key": 10,
							"value": "Product"
						},
						"value_text": "This is my text field, I hope you like it"
					}
				]
			}
		],
		"duration_metrics": [
			{
				"duration_metric": {
					"id": "01FCNDV6P870EA6S7TK1DSYD5H",
					"name": "Lasted"
				},
				"value_seconds": 1
			}
		],
		"external_issue_reference": {
			"issue_name": "INC-123",
			"issue_permalink": "https://linear.app/incident-io/issue/INC-1609/find-copywriter-to-write-up",
			"provider": "asana"
		},
		"id": "01FDAG4SAP5TYPT98WGR2N7W91",
		"incident_role_assignments": [
			{
				"assignee": {
					"email": "[e-mail]",
					"id": "01FCNDV6P870EA6S7TK1DSYDG0",
					"name": "Lisa Karlin Curtis",
					"role": "viewer",
					"slack_user_id": "U02AYNF2XJM"
				},
				"role": {
					"created_at": "2021-08-17T13:28:57.801578Z",
					"description": "The person currently coordinating the incident",
					"id": "01FCNDV6P870EA6S7TK1DSYDG0",
					"instructions": "Take point on the incident; Make sure people are clear on responsibilities",
					"name": "Incident Lead",
					"required": false,
					"role_type": "lead",
					"shortform": "lead",
					"updated_at": "2021-08-17T13:28:57.801578Z"
				}
			}
		],
		"incident_status": {
			"category": "triage",
			"created_at": "2021-08-17T13:28:57.801578Z",
			"description": "Impact has been **fully mitigated**, and we're ready to learn from this incident.",
			"id": "01FCNDV6P870EA6S7TK1DSYD5H",
			"name": "Closed",
			"rank": 4,
			"updated_at": "2021-08-17T13:28:57.801578Z"
		},
		"incident_timestamp_values": [
			{
				"incident_timestamp": {
					"id": "01FCNDV6P870EA6S7TK1DSYD5H",
					"name": "Impact started",
					"rank": 1
				},
				"value": {
					"value": "2021-08-17T13:28:57.801578Z"
				}
			}
		],
		"incident_type": {
			"create_in_triage": "always",
			"created_at": "2021-08-17T13:28:57.801578Z",
			"description": "Customer facing production outages",
			"id": "01FCNDV6P870EA6S7TK1DSYDG0",
			"is_default": false,
			"name": "Production Outage",
			"private_incidents_only": false,
			"updated_at": "2021-08-17T13:28:57.801578Z"
		},
		"mode": "standard",
		"name": "Our database is sad",
		"permalink": "https://app.incident.io/incidents/123",
		"postmortem_document_url": "https://docs.google.com/my_doc_id",
		"reference": "INC-123",
		"severity": {
			"created_at": "2021-08-17T13:28:57.801578Z",
			"description": "Issues with **low impact**.",
			"id": "01FCNDV6P870EA6S7TK1DSYDG0",
			"name": "Minor",
			"rank": 1,
			"updated_at": "2021-08-17T13:28:57.801578Z"
		},
		"slack_channel_id": "C02AW36C1M5",
		"slack_channel_name": "inc-165-green-parrot",
		"slack_team_id": "T02A1FSLE8J",
		"summary": "Our database is really really sad, and we don't know why yet.",
		"updated_at": "2021-08-17T13:28:57.801578Z",
		"visibility": "public",
		"workload_minutes_late": 40.7,
		"workload_minutes_sleeping": 0,
		"workload_minutes_total": 60.7,
		"workload_minutes_working": 20
	}
}

Workflow Library Example

Create Incident with Incidentio and Send Results Via Email

Preview this Workflow on desktop