---
title: "Send private message"
method: POST
path: "/chat/v1/conversations/privateMessage/{userId}"
tags: ["Chat:v1:Conversations"]
---

# Send private message

`POST /chat/v1/conversations/privateMessage/{userId}`

Send a private message to a specified user within the account. The sender will be a custom publisher. If a conversation between the custom publisher and the addressed user already exists, it will send the message to the same conversation, if not, it will create a new conversation with the specified user.

## Path parameters

- `userId` integer, required — The unique identifier of the user

## Request body

- ConversationPostMessageRequest
  - `senderId` integer, required — The unique identifier of the sender (custom publisher). The custom publishers page can be found in the UI under Settings -> Feed settings.
  - `text` string, required — Specifies the text content of the message. Must be in UTF-8 and less than 500 characters.
  - `attachments` union[] — List of attachments to be associated with the message.
    - union
      - ImageAttachmentRequest
        - `type` 'image', required — The type of the attachment.
        - `fileId` string, required — The unique identifier of the image.
      - FileAttachmentRequest
        - `type` 'file', required — The type of the attachment.
        - `fileId` string, required — The unique identifier of the file.

## Response `200`

Successful Response

- APIResponseBaseResponse
  - `requestId` string
  - `data` BaseResponse, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/connecteam/apis/connecteam-api-documentation.md) · [All operations](https://skmtc.net/connecteam/apis/connecteam-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/connecteam/connecteam-api-documentation/revisions/d8f7f302222e/schema)