---
title: "Create a message"
method: POST
path: "/messaging/{connection_id}/message"
tags: ["messaging", "message"]
---

# Create a message

`POST /messaging/{connection_id}/message`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/messaging/{connection_id}/message`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- MessagingMessage
  - `id` string
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `channels` MessagingReference[]: Represents all channels to which the message is sent. Identifies the channels where the message is posted. To send to the "Draft" channel/folder, use a channel ID "DRAFT".
    - `id` string
    - `name` string
  - `parent_id` string: Represents the ID of the immediate predecessor message in the thread. Identifies a specific message to which the current message directly replies.
  - `message_thread_identifier` string: the opaque identifier for the first message in a thread
  - `author_member` MessagingMessageAuthorMember: for email systems, this field represents the From value
    - `user_id` string: (reference to HrisEmployee)
    - `email` string
    - `name` string
    - `image_url` string
  - `destination_members` MessagingMember[]: for email systems, this field represents the To value
    - `user_id` string: (reference to HrisEmployee)
    - `email` string
    - `name` string
    - `image_url` string
  - `hidden_members` MessagingMember[]: for email systems, this field represents the BCC value
    - `user_id` string: (reference to HrisEmployee)
    - `email` string
    - `name` string
    - `image_url` string
  - `mentioned_members` MessagingMember[]: for email systems, this field represents the CC value
    - `user_id` string: (reference to HrisEmployee)
    - `email` string
    - `name` string
    - `image_url` string
  - `reactions` MessagingReaction[]
    - `reaction` string, required
    - `member` MessagingReactionMember, required
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
  - `subject` string
  - `message` string
  - `message_html` string
  - `message_markdown` string
  - `attachments` MessagingAttachment[]
    - `filename` string
    - `size` number
    - `content_identifier` string: the inline attachment's content_id
    - `content_type` string
    - `download_url` string
    - `message_id` string
  - `web_url` string
  - `reference` string: eg. RFC822 MessageID
  - `has_children` boolean
  - `is_unread` boolean
  - `buttons` MessagingButton[]
    - `id` string, required
    - `text` string
    - `icon` string
  - `metadata` MessagingMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown

## Response `200`

Successful

- MessagingMessage
  - `id` string
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `channels` MessagingReference[]: Represents all channels to which the message is sent. Identifies the channels where the message is posted. To send to the "Draft" channel/folder, use a channel ID "DRAFT".
    - `id` string
    - `name` string
  - `parent_id` string: Represents the ID of the immediate predecessor message in the thread. Identifies a specific message to which the current message directly replies.
  - `message_thread_identifier` string: the opaque identifier for the first message in a thread
  - `author_member` MessagingMessageAuthorMember: for email systems, this field represents the From value
    - `user_id` string: (reference to HrisEmployee)
    - `email` string
    - `name` string
    - `image_url` string
  - `destination_members` MessagingMember[]: for email systems, this field represents the To value
    - `user_id` string: (reference to HrisEmployee)
    - `email` string
    - `name` string
    - `image_url` string
  - `hidden_members` MessagingMember[]: for email systems, this field represents the BCC value
    - `user_id` string: (reference to HrisEmployee)
    - `email` string
    - `name` string
    - `image_url` string
  - `mentioned_members` MessagingMember[]: for email systems, this field represents the CC value
    - `user_id` string: (reference to HrisEmployee)
    - `email` string
    - `name` string
    - `image_url` string
  - `reactions` MessagingReaction[]
    - `reaction` string, required
    - `member` MessagingReactionMember, required
      - `user_id` string: (reference to HrisEmployee)
      - `email` string
      - `name` string
      - `image_url` string
  - `subject` string
  - `message` string
  - `message_html` string
  - `message_markdown` string
  - `attachments` MessagingAttachment[]
    - `filename` string
    - `size` number
    - `content_identifier` string: the inline attachment's content_id
    - `content_type` string
    - `download_url` string
    - `message_id` string
  - `web_url` string
  - `reference` string: eg. RFC822 MessageID
  - `has_children` boolean
  - `is_unread` boolean
  - `buttons` MessagingButton[]
    - `id` string, required
    - `text` string
    - `icon` string
  - `metadata` MessagingMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)