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

# Sync inbound message

`POST /channels/{channel_id}/inbound_messages`

## Request

- Base URL: `https://api2.frontapp.com`
- URL: `https://api2.frontapp.com/channels/{channel_id}/inbound_messages`
- Auth: HTTP bearer

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/channel-api.md) - [All operations](https://skmtc.dev/frontapp/apis/channel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frontapp/apis/channel-api/revisions/623b3ec08b56?raw)