---
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`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/messaging/ingest-external`
- Auth: none declared

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.dev/elizaos/apis/eliza-os-api.md) - [All operations](https://skmtc.dev/elizaos/apis/eliza-os-api/llms.txt) - [OpenAPI document](https://skmtc.dev/elizaos/apis/eliza-os-api/revisions/d606a12682bb?raw)