Create Incident

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

Parameter	Description
Assign to	JSON array of PagerDuty user objects to assign this incident to. e.g. [{"assignee":{"id": "USER_ID", "type": "user_reference"}}]
Created by	The email address of a valid user associated with the account making the request.
Description	Additional incident details.
Incident Urgency	The urgency of the incident.
Service ID	-
Title	A succinct description of the nature, symptoms, cause, or effect of the incident.

Example Output

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

Workflow Library Example

Create Incident with Pagerduty and Send Results Via Email

Preview this Workflow on desktop