---
title: "POST /v2/scheduler/posts/{postId}/notes"
method: POST
path: "/v2/scheduler/posts/{postId}/notes"
tags: ["Scheduled Post Notes Api Service"]
---

# POST /v2/scheduler/posts/{postId}/notes

`POST /v2/scheduler/posts/{postId}/notes`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/scheduler/posts/{postId}/notes`
- Auth: none declared

## Path parameters

- `postId` integer, required

## Query parameters

- `sourcePostId` integer

## Request body

- ScheduledPostNoteRequest
  - `content` string, required

## Response `200`

OK

- JsonOkListResponseScheduledPostNote
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` ScheduledPostNote[]
    - `id` integer, required
    - `postId` integer, required
    - `userId` integer
    - `agencyId` integer
    - `userName` string, required
    - `created` DateTimeInfo, required
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `content` string, required
    - `updatedDate` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `updated` boolean
    - `deletedDate` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `deleted` boolean
    - `profilePicture` string: Public URL of the author's 400x400 profile picture. Absent when they have none, in which case the frontend renders its initials fallback. Filled for agency-authored notes too.
    - `mentions` NoteMentionDto[]: Users mentioned in the content of the note, resolved when the note is read. Empty when the note mentions nobody.
      - `userId` integer: Regular user id of the mentioned user. Absent for an agency end client.
      - `agencyId` integer: Agency id of the mentioned user. Only for an agency end client.
      - `agencyUserId` integer: Agency user id of the mentioned user. Only for an agency end client.
      - `name` string: Current display name of the mentioned user. Absent when the account was deleted, in which case the frontend renders its own localized deleted-user label.
      - `deleted` boolean: True when the mentioned account no longer exists. A user that merely lost access to the brand is not deleted: their mention keeps rendering as it always did.
    - `mentionId` string: Identity of the note author, and the field to compare against your own to tell whether a note is yours. `12345` for a regular user, `a:<agencyId>:<agencyUserId>` for an agency end client. Prefer it over the raw id fields: an agency author's `userId` is not a regular-user id — it holds their id inside the agency, which is a different id space and can be the same number as an unrelated regular user, so comparing that one can answer "mine" on somebody else's note. Same shape as the `mentionId` of the mention picker, so the author of a note and the entry that mentions them carry the same string. Absent only for a note whose author could not be resolved.

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/cd0ca612fa01?raw)