---
title: "Sync inbound message"
method: POST
path: "/channels/{channel_id}/inbound_messages"
tags: ["Messages"]
---

# Sync inbound message

`POST /channels/{channel_id}/inbound_messages`

Import a message that was received by the channel.

## Path parameters

- `channel_id` string, required

## Request body

- InboundMessage
  - `sender` object, required — Data of the sender
    - `name` string — Name of the sender
    - `handle` string, required — Handle of the sender. 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 sender. When provided, links this contact to existing contacts with the same email to prevent duplicates across channels.
  - `subject` string — Subject of the message
  - `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.dev/frontapp/apis/core-api.md) · [All operations](https://skmtc.dev/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)