---
title: "Ingest message"
method: POST
path: "/custom-channels/{channel_id}/messages"
tags: ["Custom Channels"]
---

# Ingest message

`POST /custom-channels/{channel_id}/messages`

This endpoint lets you ingest messages in conversations that use custom channels. When called, it creates a new message in the specified conversation. If the conversation does not exist, the endpoint will automatically create the conversation before adding the message.

You must use an API key with `ORG_ADMIN` or `PROVIDER` rights for this endpoint.

⚠️ A `200 OK` response does not guarantee that the message was successfully created. 
It only means the request was received and accepted for processing. ⚠️

## Path parameters

- `channel_id` string, required — The id of the custom channel

## Request body

- object — Request body to ingest a new message in a conversation
  - `business_id` string, required — The id of the business.
  - `external_conversation_id` string, required — The unique id of the conversation in your system. Messages with the same `external_conversation_id` & `channel_id` will be grouped within the same Partoo Conversation.
  - `external_message_id` string, required — The unique id of the message in your system. Messages with the same `external_message_id` & `channel_id` will be considered as duplicates and will be ignored.
  - `content` string, required — The message content.
  - `sender_type` 'User' | 'Consumer', required
  - `consumer_name` string, nullable — Display name of the consumer. This property is only used at the creation of the conversation.
  - `consumer_image` string, nullable — Profile image URL of the consumer. This property is only used at the creation of the conversation.

## Response `200`

OK

- object
  - `status` 'success'

## Other responses

- `403` — You are not allowed to perform this action

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/revisions/3652d8b1a8b3/schema)