---
title: "Creating a new Post"
method: POST
path: "/posts"
tags: ["Posts"]
---

# Creating a new Post

`POST /posts`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/posts`
- Auth: none declared

Posts to the Activity Feed of a workspace (project).

**Bulk Create**

This endpoint supports bulk creating up to 100 objects. In the request body, set the top-level key to its plural form and place the objects in an array. Example:

```
{
  "posts": [
    {
      "workspace_id": 123,
      "message": "Post"
    },
    {
      "workspace_id": 456,
      "message": "Post"
    }
  ]
}
```


This endpoint returns structured Post objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `posts` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `include` string

## Request body

- object
  - `post` object
    - `workspace_id` integer, required: The ID of the project in which the post will be created.
    - `message` string, required: The content created in the new post.
    - `subject_id` integer: The ID of the item to which the new post is replying (only `required` for replies).
    - `subject_type` string: The type of item to which the new post is replying (only `required` for replies). Accepted values are `Post`.
    - `story_id` integer: The ID of the task to which the new post should be linked.
    - `recipient_ids` integer[]: An array of User IDs for which the post is visible. These users must be participating in the target project. Including this parameter will make the post private.
    - `attachment_ids` integer[]: An array of PostAttachment IDs to be associated with the post. Create PostAttachments using the attachments endpoint.
    - `google_documents` object[]: An array of Google document to be associated with the post.
      - `resource_id` string: A unique identifier for the Google document.
      - `access` string: Allowed access to the Google document.
    - `backdated_to` string, date-time: Backdates the post creation date on imports. Defaults to *Now*. The datetime must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.

## Response `200`

Post has been created.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `posts` object
  - `external_references` object
  - `users` object
  - `workspaces` object
  - `stories` object
  - `attachments` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)