---
title: "Ingest messages from external platforms"
method: POST
path: "/api/messaging/ingest-external"
tags: ["messaging"]
---

# Ingest messages from external platforms

`POST /api/messaging/ingest-external`

Ingest messages from external platforms (Discord, Telegram, etc.) into the central
messaging system. This endpoint handles messages from external sources and routes
them to the appropriate agents through the central message bus.

## Request body

- object
  - `agentId` string, uuid, required
  - `roomId` string, uuid, required
  - `userId` string, uuid, required
  - `text` string, required
  - `sourceId` string, required
  - `sourceType` 'discord' | 'telegram' | 'twitter', required
  - `metadata` object

## Response `200`

Message ingested successfully

- object
  - `success` boolean

## Other responses

- `400` — Invalid request
- `500` — Error ingesting message

---

[API](https://skmtc.net/elizaos/apis/eliza-os-api.md) · [All operations](https://skmtc.net/elizaos/apis/eliza-os-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elizaos/eliza-os-api/revisions/f43280bfdb0c/schema)