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

# Create a message

`POST /messaging/{connection_id}/message`

## Path parameters

- `connection_id` string, required

## Query parameters

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

## Request body

- MessagingMessage
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `channel_id` string
  - `channel_ids` string[] — @deprecated; use channels instead
  - `channels` MessagingReference[] — Represents the names of all channels to which the message is sent. Identifies the channels where the message is posted.
    - `id` string
    - `name` string
  - `parent_id` string
  - `root_message_id` string
  - `message_thread_identifier` string
  - `author_member` PropertyMessagingMessageAuthorMember — for email systems, this field represents the From value
    - `user_id` string
    - `email` string
    - `name` string
    - `image_url` string
  - `destination_members` MessagingMember[] — for email systems, this field represents the To value
    - `user_id` string
    - `email` string
    - `name` string
    - `image_url` string
  - `hidden_members` MessagingMember[] — for email systems, this field represents the BCC value
    - `user_id` string
    - `email` string
    - `name` string
    - `image_url` string
  - `mentioned_members` MessagingMember[] — for email systems, this field represents the CC value
    - `user_id` string
    - `email` string
    - `name` string
    - `image_url` string
  - `reactions` MessagingReaction[]
    - `reaction` string, required
    - `member` PropertyMessagingReactionMember, required
      - `user_id` string
      - `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
    - `content_type` string
    - `download_url` string
    - `message_id` string
  - `web_url` string
  - `reference` string
  - `has_children` boolean
  - `is_unread` boolean
  - `buttons` MessagingButton[]
    - `id` string, required
    - `text` string
    - `icon` string
  - `raw` object

## Response `200`

Successful

- MessagingMessage
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `channel_id` string
  - `channel_ids` string[] — @deprecated; use channels instead
  - `channels` MessagingReference[] — Represents the names of all channels to which the message is sent. Identifies the channels where the message is posted.
    - `id` string
    - `name` string
  - `parent_id` string
  - `root_message_id` string
  - `message_thread_identifier` string
  - `author_member` PropertyMessagingMessageAuthorMember — for email systems, this field represents the From value
    - `user_id` string
    - `email` string
    - `name` string
    - `image_url` string
  - `destination_members` MessagingMember[] — for email systems, this field represents the To value
    - `user_id` string
    - `email` string
    - `name` string
    - `image_url` string
  - `hidden_members` MessagingMember[] — for email systems, this field represents the BCC value
    - `user_id` string
    - `email` string
    - `name` string
    - `image_url` string
  - `mentioned_members` MessagingMember[] — for email systems, this field represents the CC value
    - `user_id` string
    - `email` string
    - `name` string
    - `image_url` string
  - `reactions` MessagingReaction[]
    - `reaction` string, required
    - `member` PropertyMessagingReactionMember, required
      - `user_id` string
      - `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
    - `content_type` string
    - `download_url` string
    - `message_id` string
  - `web_url` string
  - `reference` string
  - `has_children` boolean
  - `is_unread` boolean
  - `buttons` MessagingButton[]
    - `id` string, required
    - `text` string
    - `icon` string
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)