younifyd
Menu

Create Incident

Create an Incident

POST/incidents

Use it in a workflow

  1. Add a step and choose the PagerDuty connector.
  2. Pick the Create Incident action (under Incidents).
  3. Fill in the fields below, then reference the result from later steps as {{createIncident.response.data}}.

Request

Headers

Acceptstringrequired

The `Accept` header is used as a versioning header.

Default "application/vnd.pagerduty+json;version=2"

Content-Typestringrequired

One ofapplication/jsonDefault "application/json"

Fromstring (email)required

The email address of a valid user associated with the account making the request.

Request body

Enter the body as JSON in the step's Body field.

incidentobjectrequired

Details of the incident to be created.

typestringrequired

One ofincident

titlestringrequired

A succinct description of the nature, symptoms, cause, or effect of the incident.

serviceanyrequired
priorityany
urgencystring

The urgency of the incident

One ofhighlow

bodyobject1 fields
incident_keystring

A string which identifies the incident. Sending subsequent requests referencing the same service and with the same incident_key will result in those requests being rejected if an open incident matches that incident_key.

assignmentsarray<object>1 fields

Assign the incident to these assignees. Cannot be specified if an escalation policy is given.

incident_typeobject2 fields
escalation_policyany
conference_bridgeobject2 fields
json
{
  "incident": {
    "type": "incident",
    "title": "string",
    "service": null,
    "priority": null,
    "urgency": "high",
    "body": {
      "details": {}
    },
    "incident_key": "string",
    "assignments": [
      {
        "assignee": null
      }
    ],
    "incident_type": {
      "id": "string",
      "name": "string"
    },
    "escalation_policy": null,
    "conference_bridge": {
      "conference_number": "string",
      "conference_url": "string"
    }
  }
}

Response

Returns 201 with an object. Read it in later steps with {{createIncident.response.data.<field>}}.

incidentany
json
{
  "incident": null
}

Need more? See the PagerDuty guide for connection setup and behaviour shared by every action.