younifyd
Menu

Create Incident Status Update

Create a status update on an incident

POST/incidents/{id}/status_updates

Use it in a workflow

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

Request

Path parameters

idstringrequired

The ID of the resource.

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.

messagestringrequired

The message to be posted as a status update.

subjectstring

The subject to be sent for the custom html email status update. Required if sending custom html email.

html_messagestring

The html content to be sent for the custom html email status update. Required if sending custom html email.

json
{
  "message": "string",
  "subject": "string",
  "html_message": "string"
}

Response

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

status_updateobject
idstring
messagestring

The message of the status update.

created_atstring

The date/time when this status update was created.

senderany
subjectstring

The subject of the custom html email status update. Present if included in request body.

html_messagestring

The html content of the custom html email status update. Present if included in request body.

json
{
  "status_update": {
    "id": "string",
    "message": "string",
    "created_at": "string",
    "sender": null,
    "subject": "string",
    "html_message": "string"
  }
}

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