---
title: "Add a new post"
method: POST
path: "/api/v2/organizations/{orgSlug}/posts"
tags: ["Posts"]
---

# Add a new post

`POST /api/v2/organizations/{orgSlug}/posts`

Add a new post. 

 Required scopes: `flex.collaboration.posts.create`

## Path parameters

- `orgSlug` string, required

## Request body

- AddPostDto
  - `title` string, required — The title of the post.
  - `description` string, required — The content of the post.
  - `locations` string[], required — An array with the ids of all locations in which the post is visible.
  - `isPinned` boolean — Shows if the post is pinned to the top.
  - `type` 'info' | 'important' | 'event' — The type of the post.
  - `url` string — An additional url that is shown in the post.
  - `image` string — The url of the image of the post.
  - `member` string — The _id of the member that created the post.
  - `company` string — The _id of the company that created the post.

## Response `201`

- PostResultDto
  - `_id` string — The _id of the post.
  - `title` string — The title of the post.
  - `description` string — The content the post.
  - `locations` string[] — An array with the ids of all locations in which the post is visible.
  - `isPinned` boolean — Shows if the post is pinned to the top.
  - `type` 'info' | 'important' | 'event' — The type of the post.
  - `url` string — An additional url that is shown in the post.
  - `image` string — The url of the image of the post.
  - `member` string — The _id of the member that created the post.
  - `company` string — The _id of the company that created the post.
  - `createdBy` string — The user that created the post.
  - `createdAt` string — The time when the post was created.

---

[API](https://skmtc.dev/officernd/apis/authentication-api.md) · [All operations](https://skmtc.dev/officernd/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/officernd/authentication-api/revisions/6bcd33dc648e/schema)