---
title: "POST Message"
method: POST
path: "/messages"
---

# POST Message

`POST /messages`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/messages`
- Auth: API key in query parameter `access_token`

/messages
Permission level: 5

## Request body `application/x-www-form-urlencoded`

- object
  - `subject` string, required
  - `message` string, required
  - `individual_receivers` integer, required: Id of the receiver
  - `group_receivers` string, required: Position id
  - `conversation` integer: Conversation id - this parameter is used for replying the messages

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` integer
    - `conversation` integer
    - `sender` string
    - `sent` string
    - `deleted` unknown
    - `subject` string
    - `message` string
    - `grouped` integer
    - `receivers` string
    - `read` unknown
  - `metadata` unknown[]
    - unknown
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/messages/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
