---
title: "Create request notes"
method: POST
path: "/api/v1/requests/{requestId}/notes"
tags: ["requests"]
---

# Create request notes

`POST /api/v1/requests/{requestId}/notes`

## Path parameters

- `requestId` string, required

## Headers

- `X-Api-Key` string, required
- `X-Workspace-Id` string

## Request body

- object
  - `user_id` integer
  - `conversation_id` integer — When set, the reply is mirrored into this conversation's thread (UAG).
  - `description` string
  - `mentions` integer[]
  - `is_private` boolean
  - `source` 'EMAIL' | 'SLACK' | 'TEAMS' | 'PORTAL' | 'WORKFLOW' | 'JOURNEY' | 'API' | 'UNIVERSAL_AGENT'
  - `type` 'ESD_NOTE' | 'SLACK_NOTE' | 'EMAIL_NOTE' | 'RATING' | 'TEMPLATE' | 'WORKFLOW_NOTE'
  - `attachments` integer[]
  - `cc_emails` string[]
  - `bcc_emails` string[]
  - `is_broadcast` boolean
  - `external_id` string
  - `external_source_type` 'SAAS_GENIE' | 'SNOW' | 'JSM_BRIDGE'
  - `email_content` string
  - `event_created_at` string, date-time — Event creation timestamp. When provided via public API, also backdates the note's created time, SLA metrics, and activity timestamps. Must not be in the future or before the request's creation time.

## Response `200`

Successful response

- RequestsPostapiV1RequestsRequestIdNotesResponse200 — Empty response body

---

[API](https://skmtc.net/atomicwork/apis/atomicwork-public-api.md) · [All operations](https://skmtc.net/atomicwork/apis/atomicwork-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atomicwork/atomicwork-public-api/versions/2e7047b35062/schema)