---
title: "Send a new message"
method: POST
path: "/messenger/v1/messages"
tags: ["messages"]
---

# Send a new message

`POST /messenger/v1/messages`

## Request

- Base URL: `https://{domain}.uspacy.ua`
- URL: `https://{domain}.uspacy.ua/messenger/v1/messages`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/uspacy/apis/messenger-service-2/docs/messenger/v1/messages/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates and sends a new message to a chat. Supports text messages, attachments, replies, and mentions.

## Request body

- MessageDto
  - `id` string: Message id
  - `timestamp` number: Timestamp of message
  - `message` string, required: Message text
  - `type` 'MESSAGE' | 'AUDIO' | 'VIDEO' | 'GIF' | 'SYSTEM': Message type
  - `chatId` string, required: Chat id
  - `parentMessage` string: Parent message id
  - `readBy` number[]: Members ids
  - `externalLine` string: External line
  - `attachedFiles` AttachedFile[]: Attached files
    - `id` object, required: Attached file id
    - `entityId` string, required: Attached file entity id
    - `entityType` string, required: Attached file entity type
    - `lastModified` number, required: Attached file created date
    - `originalFilename` string, required: Attached file original filename
    - `size` string, required: Attached file size
    - `url` string, required: Attached file url
  - `relations` MessageRelation[]: Relations
    - `action` 'create' | 'update' | 'delete', required: Action
    - `service` 'crm', required: Service
    - `entity` 'lead' | 'contact' | 'deal', required: Entity
    - `name` string, required: Entity id
    - `pictureUrl` string, required: Entity picture url
    - `entityId` string, required: Entity id
  - `externalAuthorId` string: External author id
  - `externalId` string: External id
  - `ref` Reference
    - `chatId` string, required: Chat id
    - `authorId` number, required: Author id
    - `messageId` string, required: Message id
  - `mentioned` string[]: Mentioned users
  - `meta` MessageMeta
    - `entity` string, required: Entity name
    - `type` string, required: Entity type
    - `accountName` string, required: Account name
    - `accountImage` string, required: Account image url
    - `body` MetaBody[], required: Body entity
      - `text` string, required: Text post or stories or whatever
      - `attachedFiles` string[], required: Attached files url
      - `url` string, required: Post or stories url
  - `status` 'sent' | 'delivered' | 'read' | 'error'
  - `statusText` string

## Response `200`

The created message

- MessageResponseDto
  - `id` string: Message id
  - `timestamp` number: Timestamp of message
  - `message` string, required: Message text
  - `type` 'MESSAGE' | 'AUDIO' | 'VIDEO' | 'GIF' | 'SYSTEM': Message type
  - `chatId` string, required: Chat id
  - `readBy` number[]: Members ids
  - `externalLine` ExternalLineResponseDto, required
    - `id` string, required: External line id
    - `name` string, required: External line name
    - `icon` string, required: External line icon
    - `externalId` string, required: External line external id
    - `timestamp` number, required: External line timestamp
    - `portal` string, required: External line portal
    - `phoneNumber` string, required: External line phone number
  - `attachedFiles` AttachedFile[]: Attached files
    - `id` object, required: Attached file id
    - `entityId` string, required: Attached file entity id
    - `entityType` string, required: Attached file entity type
    - `lastModified` number, required: Attached file created date
    - `originalFilename` string, required: Attached file original filename
    - `size` string, required: Attached file size
    - `url` string, required: Attached file url
  - `relations` MessageRelation[]: Relations
    - `action` 'create' | 'update' | 'delete', required: Action
    - `service` 'crm', required: Service
    - `entity` 'lead' | 'contact' | 'deal', required: Entity
    - `name` string, required: Entity id
    - `pictureUrl` string, required: Entity picture url
    - `entityId` string, required: Entity id
  - `externalAuthorId` string: External author id
  - `externalId` string: External id
  - `ref` Reference
    - `chatId` string, required: Chat id
    - `authorId` number, required: Author id
    - `messageId` string, required: Message id
  - `meta` MessageMeta
    - `entity` string, required: Entity name
    - `type` string, required: Entity type
    - `accountName` string, required: Account name
    - `accountImage` string, required: Account image url
    - `body` MetaBody[], required: Body entity
      - `text` string, required: Text post or stories or whatever
      - `attachedFiles` string[], required: Attached files url
      - `url` string, required: Post or stories url

---

[API](https://skmtc.dev/uspacy/apis/messenger-service-2.md) - [All operations](https://skmtc.dev/uspacy/apis/messenger-service-2/llms.txt) - [OpenAPI document](https://skmtc.dev/uspacy/apis/messenger-service-2/revisions/699626a9e425?raw)