Create an incident synchronously without a corresponding event from a monitoring service.

An incident represents a problem or an issue that needs to be addressed and resolved.

For more information see the API Concepts Document.

​
Parameters

ParameterDescription
Assign toJSON array of PagerDuty user objects to assign this incident to. e.g. [{"assignee":{"id": "USER_ID", "type": "user_reference"}}]
Created byThe email address of a valid user associated with the account making the request.
DescriptionAdditional incident details.
Incident UrgencyThe urgency of the incident.
Service IDThe unique identifier of the incident service.
TitleA succinct description of the nature, symptoms, cause, or effect of the incident.

​
Example Output

{
	"incident": {
		"id": "PT4KHLK",
		"type": "incident",
		"title": "The server is on fire.",
		"summary": "[#1234] The server is on fire.",
		"self": "https://api.pagerduty.com/incidents/PT4KHLK",
		"html_url": "https://subdomain.pagerduty.com/incidents/PT4KHLK",
		"incident_number": 1234,
		"created_at": "2015-10-06T21:30:42Z",
		"updated_at": "2015-10-06T21:40:23Z",
		"status": "triggered",
		"incident_key": "baf7cf21b1da41b4b0221008339ff357",
		"service": {
			"id": "PWIXJZS",
			"type": "service_reference",
			"summary": "My Mail Service",
			"self": "https://api.pagerduty.com/services/PWIXJZS",
			"html_url": "https://subdomain.pagerduty.com/service-directory/PWIXJZS"
		},
		"priority": {
			"id": "P53ZZH5",
			"type": "priority_reference",
			"summary": "P2",
			"self": "https://api.pagerduty.com/priorities/P53ZZH5"
		},
		"assigned_via": "escalation_policy",
		"assignments": [
			{
				"at": "2015-11-10T00:31:52Z",
				"assignee": {
					"id": "PXPGF42",
					"type": "user_reference",
					"summary": "Earline Greenholt",
					"self": "https://api.pagerduty.com/users/PXPGF42",
					"html_url": "https://subdomain.pagerduty.com/users/PXPGF42"
				}
			}
		],
		"resolved_at": null,
		"last_status_change_at": "2015-10-06T21:38:23Z",
		"last_status_change_by": {
			"id": "PXPGF42",
			"type": "user_reference",
			"summary": "Earline Greenholt",
			"self": "https://api.pagerduty.com/users/PXPGF42",
			"html_url": "https://subdomain.pagerduty.com/users/PXPGF42"
		},
		"first_trigger_log_entry": {
			"id": "Q02JTSNZWHSEKV",
			"type": "trigger_log_entry_reference",
			"summary": "Triggered through the API",
			"self": "https://api.pagerduty.com/log_entries/Q02JTSNZWHSEKV?incident_id=PT4KHLK",
			"html_url": "https://subdomain.pagerduty.com/incidents/PT4KHLK/log_entries/Q02JTSNZWHSEKV"
		},
		"incident_type": {
			"name": "major_incident"
		},
		"escalation_policy": {
			"id": "PT20YPA",
			"type": "escalation_policy_reference",
			"summary": "Another Escalation Policy",
			"self": "https://api.pagerduty.com/escalation_policies/PT20YPA",
			"html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA"
		},
		"teams": [
			{
				"id": "PQ9K7I8",
				"type": "team_reference",
				"summary": "Engineering",
				"self": "https://api.pagerduty.com/teams/PQ9K7I8",
				"html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8"
			}
		],
		"urgency": "high"
	}
}

​
Workflow Library Example

Create Incident with Pagerduty and Send Results Via Email

Workflow Library

Preview this Workflow on desktop