> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://support.atomicwork.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://support.atomicwork.com/_mcp/server.

# createRequestNote

Add a note to a request.

Adds a note (comment/reply) to an existing request ticket. Notes are the primary communication mechanism within a ticket — use them
to post investigation findings, troubleshooting steps, resolution summaries,
or any other updates.

## Parameters

| Name                   | Type               | Required | Description                                                                                                               |
| ---------------------- | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `requestId`            | string             | Yes      | The request display ID (e.g., REQ-123, INC-456)                                                                           |
| `user_id`              | integer            | No       |                                                                                                                           |
| `conversation_id`      | integer            | No       | When set, the reply is mirrored into this conversation's thread (UAG).                                                    |
| `description`          | string             | No       |                                                                                                                           |
| `mentions`             | integer\[]         | No       | User IDs mentioned in the note. Mentioned users are notified and added as direct followers.                               |
| `agent_group_mentions` | integer\[]         | No       | Agent group IDs mentioned in the note. Members of these groups are notified                                               |
| `is_private`           | boolean            | No       | Default: `False`.                                                                                                         |
| `source`               | object             | No       |                                                                                                                           |
| `type`                 | object             | No       |                                                                                                                           |
| `attachments`          | integer\[]         | No       |                                                                                                                           |
| `cc_emails`            | string\[]          | No       |                                                                                                                           |
| `bcc_emails`           | string\[]          | No       |                                                                                                                           |
| `is_broadcast`         | boolean            | No       | Default: `False`.                                                                                                         |
| `external_id`          | string             | No       |                                                                                                                           |
| `external_source_type` | object             | No       |                                                                                                                           |
| `email_content`        | string             | No       |                                                                                                                           |
| `event_created_at`     | string (date-time) | No       | Event creation timestamp. When provided via public API, also backdates the note's created time, SLA metrics, and activit  |
| `transition`           | object             | No       | Applied in the same transaction as the note: both commit, or neither does. Takes the same body PATCH /requests/\{requestI |