Add Note to an Incident

PagerDuty Incident Management

📘

Availability

This workflow action is available on our Business and Enterprise for Incident Management pricing plans. Please contact our Sales Team to upgrade to an account with this action.

Description

Add a note to an existing incident. You can use notes to provide updates, context, or additional information about the incident's resolution process.

📘

Action Behavior

This action adds a note to an existing incident. Notes will be visible in the incident timeline.

Instructions

  1. If you have not done so already, please follow our instructions to Create an Incident Workflow.
  2. When you are prompted to add actions , select this action.
  3. Enter the following Inputs and then click Save. Continue following instructions to Publish the Workflow. When the action runs, you will see the Outputs listed below.

Inputs

📘

Field References

Fields with the {+} icon accept Field References, which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click {+}, or enter {{, and select relevant fields. Please see our Field References article for more information.

NameDescription
Incident IDRequired: The ID of the incident where you’re adding the note (defaults to current incident ID)
MessageRequired: The note’s message text
Assigned User IDHidden: The ID of the user assigned to the incident. If there are multiple assigned users, this defaults to the ID of the first user

Outputs

NameDescription
ResultValue that shows if the action was successful or not. Either "Success" or "Failed"
Result SummaryBrief description of what the action did or if it failed.
ErrorBrief description that is populated if the action failed.

PagerDuty API Endpoint

Endpoint used: