# Add Note to Incident — PagerDuty

> Add a text note to an incident. Notes are visible in the incident timeline and useful for documenting investigation steps, resolution details, or handoff notes. Use List Incidents or Get Incident to find the incident ID. See the…

- Key: `pagerduty-add-note-to-incident`
- Type: Action (Write)
- Version: 0.0.2
- App: PagerDuty (`pagerduty`) — https://pipedream.com/apps/pagerduty.md
- This page (HTML): https://pipedream.com/apps/pagerduty/actions/add-note-to-incident
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/pagerduty/actions/add-note-to-incident/add-note-to-incident.mjs

## Description

Add a text note to an incident. Notes are visible in the incident timeline and useful for documenting investigation steps, resolution details, or handoff notes. Use **List Incidents** or **Get Incident** to find the incident ID. [See the documentation](https://developer.pagerduty.com/api-reference/9529ec706026d-create-a-note-on-an-incident)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `incidentId` | `string` | Yes | The ID of the incident. See the docs here Options are loaded from the connected account. |
| `content` | `string` | Yes | The text content of the note to add. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "pagerduty",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "pagerduty-add-note-to-incident",
  arguments: {
    incidentId: "Incident ID",
    content: "Note Content",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "pagerduty-add-note-to-incident",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pagerduty: { authProvisionId: "apn_xxxxxxx" },
    incidentId: "Incident ID",
    content: "Note Content",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "pagerduty-add-note-to-incident",
    "configured_props": {
      "pagerduty": { "authProvisionId": "apn_xxxxxxx" },
      "incidentId": "Incident ID",
      "content": "Note Content"
    }
  }'
```

---

- App: https://pipedream.com/apps/pagerduty.md · All apps: https://pipedream.com/apps