---
title: "Create message"
method: POST
path: "/channels/{channel_id}/messages"
tags: ["Messages"]
---

# Create message

`POST /channels/{channel_id}/messages`

Send a new message from a channel. This is one of the ways to create a new [conversation](https://dev.frontapp.com/reference/conversations#creating-a-new-conversation). The new conversation will support both messages and comments (discussions).

Required scope: `messages:send`

## Path parameters

- `channel_id` string, required

## Request body

- OutboundMessage — Payload to receive an outbound message from an external system into Front.
  - `sender_name` string — Name of the sender
  - `to` object[], required — Data of the message recipient
    - `name` string — Name of the recipient
    - `handle` string, required — Handle of the recipient. It can be any string used to uniquely identify the sender. **Important:** When sending a phone number, include a country code preceded by a plus (+) sign. For example, +33 for France. If you do not send a country code or include a plus sign, Front will normalize your phone number to the USA (+1).
    - `email` string — Email of the recipient. When provided, links this contact to existing contacts with the same email to prevent duplicates across channels.
  - `subject` string — Subject of the message
  - `author_id` string — ID of the teammate on behalf of whom the message is sent
  - `body` string, required — The body of the message in HTML or plain text format.
  - `metadata` object, required
    - `external_id` string, required — External identifier of the message
    - `external_conversation_id` string, required — External identifier of the conversation. Will be used to thread messages.
    - `referenced_message_external_id` string — External identifier of the message that this message is replying to. Use this for explicit replies.
  - `delivered_at` integer — Time in seconds at which message was created in external system
  - `attachments` string[] — Binary data of attached files. Must use `Content-Type: multipart/form-data` if specified. See [example](https://gist.github.com/hdornier/e04d04921032e98271f46ff8a539a4cb) or read more about [Attachments](https://dev.frontapp.com/docs/attachments-1). Max 25 MB.

## Response `202`

An accepted message

- object
  - `status` string
  - `message_uid` string — Message unique identifier

---

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