# Add Note to an Incident

Adds a timestamped note to an incident's timeline, useful for recording updates, context, or details on how it was resolved.


> **Availability:** See the [Incident Workflow Actions Overview table](/workflow-actions) for the plans this workflow is available on.

## Description

This action adds a note to an existing incident, which will also be visible in the incident timeline. You can use notes to provide updates, context, or additional information about the incident's resolution process.

> **Incident Note Limitations:** The following limitations apply to notes on both open and resolved incidents:
>
> - An incident can have up to 2,000 notes.
> - Incident notes are limited to 65,535 single-byte characters. This typically equates to ~16,000 characters of [UTF-8](https://en.wikipedia.org/wiki/UTF-8) encoded text.

## Instructions

1. If you have not done so, follow the instructions to [Create an Incident Workflow](/ai-automation/automation/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/ai-automation/automation/incident-workflows#add-actions), select **this action**.
3. Enter the following **Inputs** and click **Save**.
4. Continue following instructions to **Publish** the Workflow.
5. When the action runs, you will see the **Outputs** listed below.

## Inputs

> **Field References:** Fields with the **\{+\}** icon accept [Field References](/ai-automation/automation/incident-workflows#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. Refer to the [Field References](/ai-automation/automation/incident-workflows#field-references) article for more information.

| Name             | Description                                                                                                                              |
| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |
| Incident ID      | **Required**: The ID of the incident where you’re adding the note (defaults to current incident ID)                                      |
| Message          | **Required**: The note’s message text                                                                                                    |
| Assigned User ID | **Hidden**: 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

| Name           | Description                                                                        |
| :------------- | :--------------------------------------------------------------------------------- |
| Result         | Value that shows if the action was successful or not. Either "Success" or "Failed" |
| Result Summary | Brief description of what the action did or if it failed.                          |
| Error          | Brief description that is populated if the action failed.                          |

## PagerDuty API Endpoint

Endpoint used:

- [Create a Note on an Incident](/developer/api/reference/rest/incidents/create-incident-note)