# Create PagerDuty incident note

Canonical URL: https://docs.fuse.init.inc/integrations/pagerduty/actions/incidents.notes.create

Append a note to an incident. Requires write. Unsafe and not exposed over MCP.

Action ID: `incidents.notes.create`
Provider: PagerDuty (`pagerduty`)
Contract version: 1

## Risk and exposure

- Risk: Write
- Idempotency: Unsafe — Retries may duplicate side effects; callers must coordinate carefully.
- Availability: Default
- Exposure: REST, SDK
- MCP hints: readOnly=false, destructive=false, idempotent=false, openWorld=true

## Required scopes

- `write`

## Input schema fields

- `incident_id`
- `content`

## Output schema fields

- `id`
- `content`
- `created_at`
- `user`
- `user.id`
- `user.summary`
- `user.html_url`
- `user.type`

Provider overview: https://docs.fuse.init.inc/integrations/pagerduty
Actions index: https://docs.fuse.init.inc/integrations/pagerduty/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/pagerduty/actions/incidents.notes.create
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/pagerduty/actions